Minimal • Fast • Tag‑based File Sorter
Sakura Sorter works on prefix tags, not filenames or extensions.
You decide destinations using short tags inside square brackets at the start of a filename.
Example download:
[gw]nature.png
gw→ green wallpapers folder- file is moved automatically after appearing in the watch directory
You can route a file to multiple folders by adding multiple tags:
[gw,n]nature.png
This file will be copied or moved to:
- Green Wallpapers
- Nature
Order does not matter.
Whitespace is ignored.
Rules map short tags → folders.
Example:
| Tag | Destination |
|---|---|
| gw | ~/Pictures/Wallpapers/Green |
| n | ~/Pictures/Nature |
Rules are editable live from the UI.
- Tags must be the first part of the filename
- Tags must be inside
[] - Tags are comma‑separated
- Case‑insensitive
Valid:
[gw]file.png
[gw] file.png
[gw,n]file.png
[gw, n]file.png
[GW,N]file.png
Invalid:
gw_file.png
[file][gw].png
- Massive history stored in SQLite
- UI displays latest 200 entries
- Search scans the entire database
- Filter by success / failure
- Inspect full JSON entry
- Delete individual entries or clear all
- YAML‑based theming
- Hot‑reloadable
- Minimal nature‑inspired palettes
- No hardcoded UI colors
Themes live in:
assets/themes/
- App runs silently in background
- Restore or quit from tray
- Optional notifications
- Python
- PyQt6
- watchdog
- SQLite
- YAML
- Python 3.10+
uvpackage manager
-
Download the source code
- Download or clone the repository
- Extract it to any directory
-
Enter the project folder
cd sakura-sorter -
Install dependencies
uv sync
-
Install the app in editable mode
python -m pip install -e . -
Run Sakura Sorter
sakura-sorter
That’s it. The UI will launch and stay resident in the system tray when closed.
MIT License
See LICENSE for details.