Intro

Junk free photo management tool set.

To copy the file to the library you would typically call python script in the cloned directory.
When you "upload" file, script will make one copy in alongside directory "images" sorted by date
and add symbolic links to specified directory names inside directory called "collection".
Therefore, it is possible to browse images by date and chosen directories, without overhead and hassle.
There are also scripts to manage and restore symlinks, as well as tips on file management.

It does not support to place files anywhere, only under directory chosen when cloning branch.
For complete commands see guide at ./home/manpage.txt or manpage section on website.

How to use

First, clone the desired branch to the desired library location:

$ git clone --branch master https://gitea.com/vsnits/Phibrajry photos

or equally use a mirror:

$ git clone --branch master https://codeberg.org/vsnits/phibrajry photos

You can choose "dev" branch if you want experimental features.
To actually contribute, do not play on directory with images and see maintenance info.

Second, install required programs and you're done.
Here is a list, do "apt install" you get it.

$ cat Phibrajry/dependencies.txt

Features

@ Non-destructive
@ Recognizes photo bursts
@ Integrated with standard tools
@ Can find unknown images in chaos
@ Small, portable, cool open source
@ Can restore broken symbolic links

Support

* Linux, bsd, macOS

Should be comfortable to use anywhere python3 and unix linux tools work.
Also works with chimera linux (bsd userland).
Image display depends on graphics protocol support, kitty terminal will display normal images,
most terminals only display in unicode which is more fun.
It can be used with no graphical desktop at all, but having one is recommended.
It stores all file hashes in memory for image identification and deduplication,
so for larger photo collections around ~200mb free ram is needed.

* (No) windows

No support for SlopOS is planned. You can try port some tools and python will
mostly work, but symbolic links work differently and I have no ideas for fixing it.
This is sadly also true about FAT and ExFAT disks as whole, so they're not supported.
See tips page/file for more details and file systems recommendation.

License

Licensed under Apache 2.0, logo images under CC-0
This is free software, everyone is free to inspect, edit and share it.
No warranty!
All you do with your images is your sole responsibility.
This software is not granted to work after the update.
You have been warned!