Directory Layout
This chapter explains the platform dependent directory layout of the application.
Directory Types
The types are
| Type | Contents |
|---|---|
| PROGRAMDIR | Binaries |
| DATADIR | Basic data directory |
| RESOURCESDIR | Configs for charts etc. |
| LANGUAGEDIR | Translations |
| CONFIGDIR | personal configuration |
Platform dependent directories are
| Type | Platform | Directory | Remark |
|---|---|---|---|
| PROGRAMDIR | Windows | c:Program Files (x86)Maitreya8 | Depends on language and installation. |
| Linux + 4.4 BSD | $prefix/bin | Prefix is usually /usr/local (GNU) or /usr (most Linuxes) | |
| Mac OS x | Maitreya8.app/Contents | ||
| DATADIR | Windows | PROGRAMDIR | |
| Linux + 4.4 BSD | $prefix/maitreya8 | ||
| Mac OS x | Maitreya8.app/Resources | ||
| RESOURCESDIR | Windows | PROGRAMDIRresources | |
| Linux + 4.4 BSD | DATADIR/resources | ||
| Mac OS x | DATADIR | ||
| LANGUAGEDIR | Windows | PROGRAMDIR | |
| Linux + 4.4 BSD | $prefix/share/locale | With subdirectories for language and messages, e.g. /usr/share/locale/de/LC_MESSAGES | |
| Mac OS x | DATADIR | ||
| CONFIGDIR | Windows | c:Usersusername.maitreya-8.0 | Depends on user name and Windows version |
| Linux + 4.4 BSD | $HOME/.maitreya-8.0 | Depends on user name | |
| Mac OS x | $HOME/.maitreya-8.0 | Depends on user name |
Details
Global configuration file
File name: CONFIGDIR/config.json
The file stores most parameters of the configuration dialog and several convenience options, e.g. window sizes. The file is read on startup and written when the application closes. It can be saved using the menu command Extras → Save Configuration, too.
The location database
File name: CONFIGDIR/geonames.db
This is a SQLite3 database file. It is created from an SQL dump geonames1000.sql in DATADIR/atlas on the first startup of the atlas dialog.
See the Atlas Database page for more information.
Sheet configuration file
It is copied to CONFIGDIR on the the first startup and contains the configuration of sheets and tables (config dialog tab User interface).
JSON Files for Yogas, Dasas, charts, printouts and Multiple Views
These files have generally two locations
- Global under $RESOURCESDIR
- Personal under $CONFIGDIR. You can create the corresponding directory and place your own files there.
The global files are provided by the official release, local files are additions by the user.
In the source code tree the global files are located under src/resources.
Order of files: first the global directory is read in alphabetical order, then the local directory.
| Item | Directory | Remark |
|---|---|---|
| Western Charts | wchart | |
| Multiple Views | mview | |
| Vedic Charts | vchart | |
| Printout | ||
| Yogas | yogas | Only local files are used. They are copied on the first startup |
| Dasa Texts | dasas |
Images
The images are located in the directory DATADIR/pics. The pictures can be used as background for graphical Dasa display or custom chart graphic configuration. Only small pictures are recommended (performance).
The True Type font
The font Saravali.ttf is located in the directory DATADIR/fonts.