Skip to content

croqaz/img-db

Repository files navigation

img-DB

Build Status Code coverage Python ver

This is img-DB, an 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/

Getting started

Download a release from https://github.com/croqaz/img-db/releases/ ; Only Linux and MacOS are supported.
Once you download the app, run:

chmod +x imgdb-*
# Linux example
./imgdb-linux-x86_64 --help
# macOS example
./imgdb-darwin-arm64 --help

There is also a Docker/ Podman image available, that you can build and run:

podman build -t img-db .
podman run -it --net=host --rm img-db --help

WHO is this for?

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

WHAT'S special about it?

There are many picture organizing apps, many of them are VERY good, but the most distinctive feature of img-DB is that it can generate 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 wanted 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 decided 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 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 parts of the code are not sufficiently tested!

However, issues and PRs are welcome!

Similar

License

MIT © Cristi Constantin.

About

img-DB is a CLI application for organizing your images

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors