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). If it's missing, acat tells you how to install it and plays without the progress bar.

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.1

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.1
File Size Uploaded Provenance
acat_player-0.1.1.tar.gz 6.4 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 14.3 kB

Release files / acat_player-0.1.1.tar.gz

Download URL acat_player-0.1.1.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6b8c25142eea0d74390e6613b3bc91d55f225536a7f7aacbfac125ee5bf59cb9
BLAKE2b-256 checksum
How to use checksums
a25e2d4a40e45fd8384cc1e7278a96839140e86fa54eaf35d5843ca2f16e23cb
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.1-py3-none-any.whl

Download URL acat_player-0.1.1-py3-none-any.whl
Size 7.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5748971dd7a3d062d55f2c36820d20a80f3e06dbd2bb9344c6dd0688ae92f5c8
BLAKE2b-256 checksum
How to use checksums
5e92fe76507907ad54869c17f28090723d12819291398bbca8b2449790c06f79
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.1

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.1 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