Before you begin

Before you begin you need some preparations.


m_Librarian is written in Python and requires Python 2.7. So install Python 2.7 first. Install required modules: SQLObject and m_lib.

Library archives

The program works with local library archives so download some. In addition to the very libraries you need to get INPX indices for them — m_Librarian cannot index libraries yet.

Configuration file

m_librarian looks up configuration file in $HOME/.config/ (if your OS is POSIX-compatible). The configuration file must be named m_librarian.conf. It must be in ini-file format. The following sections and keys are now understood:

URI = "database URI"

path = "path to the library archives"

format = "download file format"

Most programs have an option -C|–config file to use a non-default configuration file.


The program needs a database. It can work with any database supported by SQLObject. Preferred ones are: MySQL, PostgreSQL or SQLite. If you plan to use an SQL server you must create a database yourself. For SQLite, the database file will be created by the program, so it’s the simplest way of using m_Librarian.

Database URI

In configuration file define section [database] with the only key URI. The value for the key must be a Database URI in format accepted by SQLObject. Some examples:

URI = mysql://user:password@host/database

URI = postgres://user@host/database

URI = sqlite:///full/path/to/database

See some more examples in sample/m_librarian.conf. See detailed description for DB URIs in SQLObject documentation.