antarctiteex-mp3-player
A terminal interface for playing and organizing a folder of MP3 files.
Features
- Local MP3 Playback
- Library Search and Filtering
- Playlist Creation, Renaming, and Deletion
- Automatic Artist-Tag Playlists with Manual Drag-and-Drop Fallback
- Drag-and-Drop Playlist Management
- Shift-Click Range Selection and Multi-Song Actions
- Loop and Weighted Shuffle Playback
- Play Count, Listening Time, Duration, and Last-Played Tracking
- Library Sorting by Name, Play Time, Plays, Duration, or Last Played
- YouTube Search and Preview
- YouTube Audio Downloads with Live Progress
- YouTube Sorting by Title, Channel, Views, or Likes
- Apple Music Radio (macOS)
- Play, Pause, Seek, and Volume Controls
- Automatic Per-Song Volume Normalization
- Keyboard, Mouse, and Media-Key Controls
- In-App Success, Warning, and Error Notifications
- MP3 Renaming and Trash-Safe Deletion
- Multi-Song Selection and Bulk Actions
- Automatic Pause for Screen Lock and Find My Alerts (macOS)
- Non-Speaker Safety Mode (macOS)
- MP3 Filename Export
- Responsive Terminal Interface
- Unified Song, Playlist, and Analysis Cache
Install
Install the player from PyPI:
python3 -m pip install antarctiteex-mp3-player
Then open a music folder and launch the player:
cd /path/to/music
antarctiteex
You can also pass the music folder directly:
antarctiteex /path/to/music
The mp3-player command is also available as an alias.
The player stores song metadata, playlists, and analysis in a single
.mp3cache.json file inside the selected music folder.
ffmpeg and ffprobe must be available on PATH for audio conversion and
analysis features. On macOS, install them with brew install ffmpeg.
Development
Run the test suite with:
python3 -m unittest test_play.py
1 maintainer
Metadata
1 maintainer
Release files for antarctiteex-mp3-player 0.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| antarctiteex_mp3_player-0.1.7.tar.gz | 61.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| antarctiteex_mp3_player-0.1.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 124.6 kB
Release files / antarctiteex_mp3_player-0.1.7.tar.gz
| Download URL | antarctiteex_mp3_player-0.1.7.tar.gz |
|---|---|
| Size | 61.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e950a8ece7a8475decd7e02e1c1a53348344629ea257f95bc3026f5318cdbbc4
|
|
BLAKE2b-256 checksum How to use checksums |
70b6d428131f46c82f94664c4d757cadcc31a140d9705fb1f2213f7261dc9d44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / antarctiteex_mp3_player-0.1.7-py3-none-any.whl
| Download URL | antarctiteex_mp3_player-0.1.7-py3-none-any.whl |
|---|---|
| Size | 63.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
98f19948d0984eea3112e401584459a242454ad584b9fcf58bdb5f9ad5cacc50
|
|
BLAKE2b-256 checksum How to use checksums |
f8acb3caf0cf5b9e031bf5b9b6fe630f1d5914a5fc77edbd3876a8ce923f1701
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
