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 print
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.