MiAZ is a personal document organiser for the GNOME desktop. It enforces a strict 7-field filename convention so every document you store is always findable by date, country, group, sender, purpose, concept, and recipient.
Keeping family records, school files, invoices, and administrative paperwork organised is a constant challenge, especially when documents arrive from many different countries and institutions.
There is no database: the directory itself is the database. All metadata lives in the filename, which means your files are fully portable and readable in any file manager.
MiAZ solves this with a simple, consistent file-naming convention of seven fields. Scan a letter, download an email attachment, drop it into your MiAZ repository, and the app guides you through naming it correctly with minimal effort.
- Multiple repositories: keep work, home, and archive documents separate
- No database: the directory is the database; files are always portable
- Workspace: fast, filterable list that handles thousands of documents
- Sidebar filters: per-field dropdowns for date, country, group, sender, purpose, and recipient
- Single and mass renaming: fix one document or rename many at once
- Project management: group related documents into named projects
- Plugin system: extend functionality with plugins
Every document managed by MiAZ follows this seven-field scheme:
{date}-{country}-{group}-{sentby}-{purpose}-{concept}-{sentto}
| Field | Format | Example |
|---|---|---|
| Date | %Y%m%d |
20240315 |
| Country | ISO 3166-1 Alpha-2 | ES |
| Group | 3-char code | HOU, FIN, EDU |
| SentBy | Free text (no hyphens) | BANKNAME |
| Purpose | 3-char code | INV, REQ, INF |
| Concept | Free text | Q1invoice |
| SentTo | Free text (no hyphens) | JOHNDOE |
Fields are separated by hyphens. The date-first order means files sort chronologically in any file browser.
Download the .deb package from the latest release and install:
- From file browser: double click in the
.debpackage. The Software Manager should let you install it. - From command line:
sudo dpkg -i ./miaz_*.deb
sudo apt-get install -f # resolve any missing dependenciesDownload the .rpm package from the latest release and install:
- From file browser: double click in the
.debpackage. The Software Manager should let you install it. - From command line:
sudo dnf install ./miaz-*.rpmPackage provided but not recommended. Because the application runs inside a sandbox, it does not have access to certain system resources and applications (e.g. scanner software), which negatively impacts the user experience.
Download the .flatpak package from the latest release and install:
- From file browser: double click in the
.debpackage. The Software Manager should let you install it. - From command line:
sudo dnf install ./miaz-*.rpmDownload the .AppImage package from the latest release and install:
- From file browser:
- Open the file properties and activate the option
Executable as Program - Double click in the
.AppImagepackage. MiAZ
- Open the file properties and activate the option
- From command line:
chmod +x ./miaz-*.AppImage
./miaz-*.AppImageRequirements: Python ≥ 3.9, GTK ≥ 4.10, Libadwaita ≥ 1.6, PyGObject ≥ 3.50, meson, ninja.
git clone https://github.com/t00m/MiAZ
cd MiAZ
./scripts/install/local/install_user.shTo uninstall:
./scripts/uninstall/uninstall_user.sh- Debian 13.5
- Last Ubuntu LTS
- Last Fedora
| Dependency | Minimum version |
|---|---|
| Python | 3.9 |
| GTK | 4.10 |
| Libadwaita | 1.6 |
| PyGObject | 3.50 |
Bug reports and feature requests: GitHub Issues
My name is Tomás Vírseda. Originally from Spain, currently working in Luxembourg as (SAP Basis) System Adminstrator/Consultant and living in Germany. Having fun with Linux and Free Software/Software Libre since 1997.
Feel free to reach out: tomasvirseda@gmail.com
GPL v3 (see data/docs/LICENSE).
-
This software application is currently in development and is not yet ready for production use. The application may contain bugs, errors, or other issues that could cause your computer or device to malfunction or experience other unexpected behaviors. By using this application, you acknowledge and agree that you do so at your own risk, and that the developer and any other parties involved in the development, distribution, or support of this application are not responsible for any damages or losses that may result from its use.*
-
This software application performs typical file operations (such as copy, rename, delete) at Operating System level. Make sure you have a backup of those files.
-
Be aware that files added to the repository directory, are automatically renamed to comply with MiAZ rules.
-
Please note that this application is based on the GPL v3 license, and is provided free of charge. There is no guarantee of any kind, either express or implied, regarding its functionality, reliability, or suitability for any particular purpose. The developer reserves the right to modify, update, or discontinue this application at any time, and may not provide support or assistance in resolving any issues or problems that arise from its use. However, you are free to grab, extend, improve and fork the code as you want.