Installation

Installation

Requirements

• Python 3.11 or higher
• Tkinter (usually included with Python)
• Pillow (PIL) for image handling
• python-barcode for barcode generation

Step-by-Step Installation

1. Clone the Repository

git clone https://github.com/1966bc/inventarium.git
cd inventarium

2. Create a Virtual Environment (Recommended)

Linux/macOS:

python3 -m venv venv
source venv/bin/activate

Windows:

python -m venv venv
venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt

Or install manually:

pip install Pillow python-barcode

4. Configure the Database

The first time you run Inventarium, it will automatically create config.ini from the template. The default configuration points to the demo database at sql/inventarium.db.

To manually configure:

cp config.ini.example config.ini

Edit config.ini to set your database path:

[database]
path = sql/inventarium.db

5. Run the Application

python3 inventarium.py

Network Installation (Shared Database)

For multi-user setups, you can place the database on a shared network folder:

[database]
# Linux network share
path = /mnt/share/inventarium/inventarium.db

# Windows UNC path
path = //server/share/inventarium.db

Note: SQLite supports concurrent reads but only one write at a time. For small teams (2-5 users), this is usually sufficient.

Troubleshooting

"No module named tkinter"

Ubuntu/Debian:

sudo apt install python3-tk

Fedora:

sudo dnf install python3-tkinter

macOS: Tkinter is included with the official Python installer from python.org.

Database Not Found

If you see "Database not found" error:

1. Check that config.ini exists
2. Verify the path in config.ini is correct
3. Ensure the database file exists at the specified path

Permission Errors

Make sure you have read/write permissions on:

• The database file
• The barcodes/ directory (for barcode generation)
• The log.txt file

---

Home | Quick Start →