Filez4Eva

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 name
file: 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>

Release files for filez4eva 3.0.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for filez4eva 3.0.13
File	Size	Uploaded
filez4eva-3.0.13.tar.gz	3.8 kB	Jun 20, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for filez4eva 3.0.13
File	Interpreter	ABI	Platform	Reset
filez4eva-3.0.13-py3-none-any.whl 5.8 kB Jun 20, 2025	Python 3	none	any	Details

Total release size: 9.7 kB

Release files / filez4eva-3.0.13.tar.gz

Download URL	filez4eva-3.0.13.tar.gz
Size	3.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`3c15e6a31dcfef7c9ef577f022ec5df63eba956b179ce4e8315538ac296f6552`
BLAKE2b-256 checksum How to use checksums	`93e07f9bb778eca7372b708e1ba5a304b4d17ce660b58af5fb1b2996e3ae147c`
Upload date	Jun 20, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.5`

Release files / filez4eva-3.0.13-py3-none-any.whl

Download URL	filez4eva-3.0.13-py3-none-any.whl
Size	5.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`62639fe9c4152689e8be95d0cb84e15ff9193eb7d53ba8e1f1272eb98f3c0b28`
BLAKE2b-256 checksum How to use checksums	`b9b59b417716575f5422831461f5d962df2e77113e3e02009e356d3e00bbfd5c`
Upload date	Jun 20, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.5`