sleepyconvert is a Typer CLI that converts files between formats, inferring intent solely from the input and output extensions — no subcommands, no flags to memorize. Point it at a source and a destination and it does the right thing.

Install

uv tool install sleepyconvert     # or: pipx install sleepyconvert

-v / --version prints the version and best-effort checks PyPI for a newer release — it works even when placed alongside the paths.

Configure

sleepyconvert is a sleepy util and reads its settings from the shared ~/sleepyconfig/params.yml, using the convert_ key prefix. If the file is absent it writes only its own section (below) and says so; if a value it needs is missing it prints this snippet and asks you to verify your config.

# sleepyconvert
convert_output_archive_dir: null   # a dir → also save a dated copy of every output; null → off

• convert_output_archive_dir — when set to a directory, every conversion also drops a dated copy of its output there as <archive_dir>/<yyyy>_<mm>_<dd>_<output_filename>.

Supported conversions

Any pair within the same category is valid (in either direction); cross-category conversions are rejected.

Usage

sleepyconvert <input_path> <output_path>

Both paths resolve relative to the current directory, and their extensions decide the conversion.

Data — round-trip between tabular formats:

$ sleepyconvert sales.csv sales.parquet
Created /Users/dingus/work/sales.parquet

Images — re-encode between raster formats:

$ sleepyconvert photo.png photo.jpg
Created /Users/dingus/pics/photo.jpg

Documents — convert between markup and PDF:

$ sleepyconvert notes.md notes.pdf
Created /Users/dingus/docs/notes.pdf

With convert_output_archive_dir set, each conversion also writes a dated archive copy:

$ sleepyconvert sales.csv sales.parquet
Created /Users/dingus/work/sales.parquet
Archived copy written to /Users/dingus/archive/2026_02_09_sales.parquet

Mixing categories fails fast with a clear message:

$ sleepyconvert data.csv chart.png
Error: Input and output extensions must belong to the same type group.
Use `convert --help` to see the supported categories.

Development

uv venv
uv pip install -e ".[dev]"
uv run pytest          # or ./tools/test.sh

Documentation

• Specification — what the tool does
• Project outline — repository layout
• Test drive — setup, testing, and CLI usage
• Adding a conversion — how to add a new format pair
• Publishing — release to PyPI