Ardi frequently asked questions

How to install Ardi?

Windows: download and run setup file from here. Follow default installation options.

Unix: download tar file from here into local folder (could be ~/Downloads/). Enter commands:

tar xvf ardi.tar.gz
chmod +x install-ardi
./install-ardi


OSX: download dmg container file from here.
Double click on downloaded file to open it content. Drag application from the .dmg window into /Applications to install (may need an administrator password).

How to run Ardi?

Windows: find Ardi shortcut on desktop or in start menu. Also you can create new one from folder where Ardi is installed.

Unix: find Ardi shortcut (icon) on desktop or use start script in Ardi installation bin-folder. By default it is ~/OsoftArdi/bin. Inside the folder find script start-ardi.sh. Execute the script to start program.

OSX: find Ardi shortcut (icon) in /Applications. Double click to launch the program.

Where are my data files?

Windows: C:\Users\[user-name]\AppData\Roaming\OsoftArdi - is the folder that contains Ardi database file called ardi.sqlite
*sustitute '[user-name]' with your login name.

Unix: ~/OsoftArdi/.data - default database folder. Database file ardi.sqlite

OSX:  /Users/[user-name]/Library/Preferences/OsoftArdi/ardi.sqlite

How to change default installation path?

Please be advised that normally you should not change this setting.
Windows: You can change it during installation procedure. If the program is installed setup environment variable ARD_ROOT_DIR. Normally you should not do this and if environment variable is not defined Ardi will use default data location.

Unix: You can change installation folder and database folder before installing the program or after. If the program is already installed look for start-ardi.sh script and change environment variable ARD_ROOT_DIR to appropriate values. If you want to specify different install path before program setup modify ardi-setup script, notice that it also uses mentioned above variable. You have to know basic scripting in Unix to do this.

OSX: Use ARD_ROOT_DIR to setup path to the database directory

How to report an issue?

Windows: look for folder logs in data directory. Zip the folder and send to our support team with description of the problem.

Unix: the logs folder should be in the installation directory, next to the bin folder. Tar the folder

tar czvf logs.tar.gz logs
and send it to support team.

OSX: Locate data folder first. Usually /Users/[user-name]/Library/Preferences/OsoftArdi/ Inside data folder find 'log' subfolder. Tar the folder
tar czvf logs.tar.gz logs
and send it to support team.

What is Ardi database format?

SQLite - SQL open source database.

Where do I start with Ardi?

Download, Install, Register (via Help|Register). Start program, see tabs with labels on the left side, marked Pad, Plan, Fit etc. Select different tabs see how outline presentation is changing, try Plan tab with different graph option/types, see critical path (CPM) diagrams in Plan tab. Select Note tab, start typing text in note, select Image tab and try to add some images for a topic. Go back to Pad tab, create some topics, assign Hotspot & ToDo attributes. If you have Dropbox account you can try cloud synchronization right away and synchronize against it from different device/computer running Ardi to test data replication. You can replicate data between iPhone, any Android device and local desktop computer running Windows, Mac OS or Ubuntu. The data replication will happen through the Dropbox cloud service.

What are main building block in Ardi outline structure?

The short answer is "Topic". All nodes presented in Outline are topics. Topic itself can have subtopics without limitation on depth and number and can have some extra features attached to it as needed. For example - once you start typing text in Note tab, selected Topic will get new note automatically attached. Same way you can attach one or many images or put topic under Project folder and project-related attributes will be attached - duration, start, cost, predecessors etc. Also Hotspots & ToDo attributes are attached on demand. Topic was made flexible, that way it is easy to extend and convert any existing outline. Also it is easy to replicate and gives some advantage during internal data storage optimization.

What are Ardi images?

Images are assigned to the notes. So it is easy to write some text for an image or collection of images. There is special view that allows browsing of images in albums. Album essentially is collection of images within one note.

What tools were used to create Ardi?

GNU toolchain, Emacs, Cygwin, XCode, VisualStudio.
Emacs Ubuntu

How the code name for current version was chosen?

"Quest for Fire" is the codename for current version 6 of Ardi. Somehow developers got inspired by "Quest for Fire" - a 1981 film adaptation of the 1911 Belgian novel by J.-H. Rosny (1856.1940).

How data is being synchronized in Ardi?

First of all data can be truly synchronized not just replicated or copied over. It was designed to work through the cloud service. Dropbox was selected as proven to be reliable and remains the only cloud synchronization media as of now. It can be extended though, for example Google Drive was successfully tested as well. Please note that main data synchronization happen inside Ardi and Cloud storage API is used only to deliver database files and media files. As data in program are managed per database file (or just Ardi file) so is synchronization. You can create a new file called "MySharedData", for example, put there notes & project you want to share among another instances of program of users and synchronize it. Program will do best effort to maintain data integrity and replicate modified properties. Please note that Ardi developers give no guaranty on your data whatsoever, you have to use it at your own discretion. Regular data backup is enable by default and optional manual backup in encouraged.

How does synchronization algorithm work?

The process starts with cloning database file. It happens automatically first time you synchronize 2 databases. Only selected (opened) file is synchronized, all other Ardi files will remain unaffected and won't be shared on the Cloud. After cloning two databases becomes identical and can be edited independently from two different places. Next time you invoke synchronization Ardi will make best effort to ensure two independently edited tree structures are identical again and ready for next synchronization cycle.