/img-db

img-DB is a CLI application for organizing your images

Primary LanguagePythonMIT LicenseMIT

img-DB

Build Status Code coverage Python ver

This is img-DB, a CLI application for organizing your images, written in Python.

Check the docs in Docs/readme.md.

Check my little intro article: https://crlf.link/log/entries/220414-img-db/

WHO is this for?

It's for anyone comfortable enough to run a CLI app with lots of options.
At the moment, there are rough edges and possibly, serious bugs...
If you want a user-frienly app, look at the similar apps below ↓

WHAT'S special about it?

There's many picture organizing apps, many of them are VERY good, but the most distinctive feature of img-DB is that it generates real folders that you can explore with a regular file explorer and that the database is an HTML gallery that you can just open in any browser. To me, this idea is very powerful.

WHY did I make this project?

Because I want to get rid of iCloud, Google Photos, Dropbox and other horrible, privacy nightmare cloud services.
img-DB is open source, offline, private, it doesn't upload your pictures anywhere (but you can, it's your pictures, do WTF you want).

WHEN did I start this?

Probably in 2015, I started collecting all kinds of Python scripts for auto-renaming pictures, auto-resizing, converting, compressing, etc.
The scripts became a mess and I thought to organize them into a proper project and also I was absolutely fascinated by the idea of creating smart folders from an archive.
The DB as a HTML file was more like a debug feature initially, so I can see what I'm importing, but it looks like the LXML parser can easily handle tens of thousands of IMG elements instantly, so it became a core feature.

DISCLAIMER

This is my hobby project AND I have a full time job AND I have a family. In other words, I may not have time to fully support this project.

Also the code is not sufficiently tested!

However, issues and PRs are welcome!

Similar

License

MIT © Cristi Constantin.