Skip to main content

SIXAMP

A 1990s-style MP3 player for the terminal, drawn entirely in Sixel graphics: a spectrum analyser, a ten-band equalizer, a playlist and a file browser, all driven by the keyboard or the mouse.

SIXAMP in xterm

Install

pip install sixamp
sixamp ~/Music

You can pass files, folders or .m3u playlists. Without arguments SIXAMP reopens your last playlist. It plays MP3, FLAC, WAV and Ogg Vorbis on Linux, macOS and Windows.

sixamp.py is also a single self-contained file: with numpy and miniaudio installed you can run python sixamp.py directly.

Terminals

SIXAMP needs a terminal that shows Sixel graphics, for example foot, WezTerm, Konsole, mlterm, iTerm2, Contour, Windows Terminal 1.22 or newer, or xterm -ti vt340. Kitty and Alacritty do not support Sixel.

To check a terminal, run sixamp --probe: you should see coloured stripes. If the skin looks scrambled, the terminal could not report its cell size; pass it yourself with --cell WIDTHxHEIGHT, for example --cell 10x20.

Keys

Key Action Key Action
z previous track b next track
x play c / Space pause
v stop l open files
Left / Right seek 5 seconds + / - volume
[ / ] balance Up / Down, Enter choose and play a track
j jump to a track i track info
r / s repeat / shuffle e / p equalizer / playlist window
o / n equalizer on / next preset f playlist format
w visualizer mode t elapsed / remaining time
d pixel scale ? / q help / quit

Everything on the skin also works with the mouse. The wheel scrolls the playlist, moves the slider under the pointer, or changes the volume.

Options

sixamp [--format TEXT] [--scale N] [--cell WxH] [--no-audio] [--probe] [--debug] [PATH ...]

--format sets the playlist line, for example --format "%n. %t (%a)". The codes are %n number, %a artist, %t title, %l album, %f file name, %d folder and %% a percent sign. Run sixamp --help for everything.

Settings are stored in ~/.config/sixamp/state.json and the log in ~/.cache/sixamp.log.

pyterm

pyterm ships SIXAMP support built in, through its sixamp_support plugin: a persistent Sixel layer, exact mouse positions and live cell sizes across theme changes. Keep plugins enabled when you run SIXAMP there.

Licence

MIT, see LICENSE. The bundled 5x7 font comes from the Adafruit GFX Library under the BSD licence; see THIRD_PARTY_NOTICES.

SIXAMP is an independent project inspired by the look of classic desktop music players. It is not affiliated with, endorsed by or connected to Winamp, Nullsoft or Llama Group. All graphics are original.

Metadata

Release files for sixamp 1.0.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 sixamp 1.0.0
File Size Uploaded Provenance Actions
sixamp-1.0.0.tar.gz 31.8 kB With provenance Details for sixamp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sixamp 1.0.0
File Interpreter ABI Platform Actions
sixamp-1.0.0-py3-none-any.whl Python 3 none any Details for sixamp-1.0.0-py3-none-any.whl

Total release size: 64.6 kB

Release files / sixamp-1.0.0.tar.gz

Download URL sixamp-1.0.0.tar.gz
Size 31.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9524a980827c7b9fd964c7e0805d02d05467261f0a95deebce3134cc22d5b192
BLAKE2b-256 checksum
How to use checksums
f7c04c763ab25aad562faba72c2c4a55227e4c80cbabb9a1cd50591165e3d7aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 7, 2026.

Transparency log

Release files / sixamp-1.0.0-py3-none-any.whl

Download URL sixamp-1.0.0-py3-none-any.whl
Size 32.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b0b1b97b1c627978c6eb35185ca6fbaac4dfe2a65f76b18201ee96b5593a3548
BLAKE2b-256 checksum
How to use checksums
e07476d836f999c42706b943e49cb643e5d154dc75a11c7f3e3f66b2a48af4b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 7, 2026.

Transparency log

Security for sixamp 1.0.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sixamp-1.0.0.tar.gz

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 Nov 7, 2026.

Transparency log

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

1.0.0 This release

2 release files Full 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