Skip to main content

acat

cat prints files. acat plays them.

Audio and video in your terminal, for humans.

$ acat song.mp3
  ▶ 1:42 / 3:58  ███████████████████░░░░░░░░░░░░░░░░░░░░░  vol 100%
  [←/→] ∓5s  [a/d] ∓30s  [space] pause  [↑/↓] volume  [n] next  [p] prev  [q] quit

Install

$ uv tool install acat-player

Or pipx install acat-player. The command is acat.

acat uses ffmpeg for the player and for video (brew install ffmpeg, apt install ffmpeg).

Usage

$ acat song.mp3                          # play a file
$ acat talk.mp4                          # videos play their audio track
$ acat intro.wav verse.mp3 outro.flac    # one after another, like cat
$ curl -s https://example.com/beep.wav | acat
$ acat -q song.mp3                       # no bar, no controls, just sound

Anything ffmpeg can read works: mp3, wav, flac, m4a, ogg, mp4, mov, mkv, webm, avi, and friends.

Controls

Key Does
space pause / resume
← → back / forward 5s
a d back / forward 30s
↑ ↓ volume
n p next / previous file
q quit

When piped, quiet, or without ffmpeg, acat falls back to a player you already have (afplay, ffplay, mpv, paplay, or aplay) and just plays.

Development

$ uv run pytest

License

ISC. Made for humans, and their ears.

Metadata

Release files for acat-player 0.1.0

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

Source distribution (sdist)

Source distribution for acat-player 0.1.0
File Size Uploaded Provenance
acat_player-0.1.0.tar.gz 6.1 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for acat-player 0.1.0
File Interpreter ABI Platform
acat_player-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.7 kB

Release files / acat_player-0.1.0.tar.gz

Download URL acat_player-0.1.0.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
00ff302a38d988434aa63ed2b970e48c4da18a735892a256c536e497758885a9
BLAKE2b-256 checksum
How to use checksums
052ca663450112d545b62d627401caeeb035dec6a7729025d91c7a32376bb424
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / acat_player-0.1.0-py3-none-any.whl

Download URL acat_player-0.1.0-py3-none-any.whl
Size 7.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
56ba2ddd0ed96f31ab3943e376bf519c8e2e41f6acf081ca56ebc3dd36b3d54f
BLAKE2b-256 checksum
How to use checksums
f4d8c29c1b9eb8225878f67a16f8b5049fad4a04116ec0a854e327c367fcff6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for acat-player 0.1.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page