sixamp 1.0.0__py3-none-any.whl

sixamp-1.0.0.dist-info/METADATA

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: sixamp
+Version: 1.0.0
+Summary: A 1990s-style MP3 player for the terminal, drawn in Sixel graphics, with spectrum analyser, equalizer and playlist
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/pez2001/sixamp
+Project-URL: Issues, https://github.com/pez2001/sixamp/issues
+Project-URL: Changelog, https://github.com/pez2001/sixamp/blob/main/CHANGELOG.md
+Keywords: mp3,music player,sixel,terminal,tui,retro,equalizer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
+Classifier: Topic :: Terminals
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES
+Requires-Dist: numpy>=1.21
+Requires-Dist: miniaudio>=1.59
+Dynamic: license-file
+
+# 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](https://raw.githubusercontent.com/pez2001/sixamp/main/docs/screenshot.png)
+
+## 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](https://github.com/pez2001/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](LICENSE). The bundled 5x7 font comes from the Adafruit GFX Library
+under the BSD licence; see [THIRD_PARTY_NOTICES](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.

sixamp-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+sixamp.py,sha256=o4zaw_iOEh3__AGokmVGuGbalmTBJ2kpULFCJyUo93k,90027
+sixamp-1.0.0.dist-info/licenses/LICENSE,sha256=OVt1UPsZOcjLtcTCDBLt1Rr690N-UUcfRzBGZxdDjfQ,1064
+sixamp-1.0.0.dist-info/licenses/THIRD_PARTY_NOTICES,sha256=3aDgMlnGot2o1w3yIWEzAu1TrhSsF4sN-gk5jOa9mJM,2038
+sixamp-1.0.0.dist-info/METADATA,sha256=7T8UrhRu2CXYK_D26oECBcbt9QwABMLu99Fed-KTunc,4089
+sixamp-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+sixamp-1.0.0.dist-info/entry_points.txt,sha256=_u0MMZi1RSUdTT_TkvNxOp-D_YNaiv_2d2i-99JmG9E,39
+sixamp-1.0.0.dist-info/top_level.txt,sha256=bAX8xZLhGRJNlubyBSA5bO3ojSCj2gZXrW4L4RvjEaE,7
+sixamp-1.0.0.dist-info/RECORD,,

sixamp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sixamp-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sixamp = sixamp:main

sixamp-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pez2001
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sixamp-1.0.0.dist-info/licenses/THIRD_PARTY_NOTICES

@@ -0,0 +1,39 @@
+SIXAMP includes the following third-party material.
+
+------------------------------------------------------------------------------
+5x7 bitmap font (the _F57 table in sixamp.py)
+From the Adafruit GFX Library, https://github.com/adafruit/Adafruit-GFX-Library
+One glyph ("y") was modified.
+------------------------------------------------------------------------------
+
+Software License Agreement (BSD License)
+
+Copyright (c) 2012 Adafruit Industries. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice,
+this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+Runtime dependencies (installed separately with pip, not bundled)
+------------------------------------------------------------------------------
+numpy      BSD-3-Clause   https://numpy.org
+miniaudio  MIT            https://github.com/irmen/pyminiaudio

sixamp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sixamp