Filez4Eva
⚠️ DISCLAIMER: This is a hobby/personal project. Not a commercial product. Not for production use.
Shift scans, photos, and other files into structured folders for permanent safekeeping
Filez4Eva is a command-line tool that helps you organize files by naming them correctly and placing them in the right directory structure. It's especially useful for managing account documents, scanned files, and other personal records.
Installation
It's best to install using pipx:
pipx install filez4eva
If you don't have pipx installed, visit the pipx site for installation instructions.
Usage
Stowing Individual Files
To organize a single file (like a downloaded PDF):
filez4eva stow-file ~/Desktop/123456789SomeFileIDownloaded.pdf
Filez4Eva will interactively prompt for:
- Date in YYYYMMDD format
- Account name (with tab-completion from existing accounts)
- Part name (with tab-completion from existing files for that account)
Processing Multiple Files
To process all files in a directory:
filez4eva stow-dir ~/Desktop
This interactive process lets you:
- Skip a file (x)
- Preview a file (p)
- Stow a file (s)
- Delete a file (d)
- Quit processing (q)
Command Line Options
Global options:
--config PATH: Specify path to config file--debug: Enable debug output
stow-file command:
--date, -d DATE: Specify date in YYYYMMDD format--account, -a ACCOUNT: Specify account name--part, -p PART: Specify part namefile: Path to the file to stow
stow-dir command:
dir: Optional path to directory to scan (defaults to configured source)
Configuration
Create a filez4eva.yml file with:
filez4eva:
source: '~/Desktop' # Default source directory
target: '~/Dropbox/accounts' # Target directory for stowed files
Files will be organized in this pattern:
~/Dropbox/accounts/<year>/<account>/<date>-<part>.<extension>
Metadata
Release files for filez4eva 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| filez4eva-4.0.0.tar.gz | 4.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| filez4eva-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.4 kB
Release files / filez4eva-4.0.0.tar.gz
| Download URL | filez4eva-4.0.0.tar.gz |
|---|---|
| Size | 4.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6bf12bf54a305db280798387f3551b83a47cc76733073adac8d1026e0978f47e
|
|
BLAKE2b-256 checksum How to use checksums |
69c921b90e38fe84c404b62af4cf68a9511465cda7148a7668c7d4448fba3534
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency logRelease files / filez4eva-4.0.0-py3-none-any.whl
| Download URL | filez4eva-4.0.0-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d317b25462507966dba5aa56f39ee92f42a74c3c15f1c5b3d39f80b1c3f13141
|
|
BLAKE2b-256 checksum How to use checksums |
465575f9208c002f050712ce6ad8340b2a4074ab6c2d0cb9cc80a3267db9cc6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.
Transparency log
