https://github.com/norm/deck
A digital music player for the 20th century.
https://github.com/norm/deck
Last synced: about 1 month ago
JSON representation
A digital music player for the 20th century.
- Host: GitHub
- URL: https://github.com/norm/deck
- Owner: norm
- Created: 2021-10-31T08:57:05.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-06-02T05:48:57.000Z (about 4 years ago)
- Last Synced: 2025-12-12T21:35:47.832Z (7 months ago)
- Language: Python
- Size: 56.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
Awesome Lists containing this project
README
deck
====
A digital music player for the 20th century.
## The problem to solve
I still mostly listen to music from my own music library, for two reasons:
* there are many albums and tracks important to me that just don't exist on
streaming services.
* I am far too used to choosing music to listen to using smart playlists,
such as "my favourites that I've not listened to in over two months"
Plus, more than once I've been in the situation where my current library
(iTunes) has stopped syncing to my phone, corrupted itself, or just revamped
the UI to make it harder for me to listen to music so Apple can promote their
streaming service.
## The design
The whiteboard sketch level description is:
1. A way of storing, categorising, and arranging music.
* add music from local files
* add music from CDs
* add music from the internet
* sync playlists to/from streaming services
* use useful metadata from musicbrainz/last.fm/etc
* store complete history of metadata updates (inc import from last.fm of
historical plays)
2. Copies of this collection living in the cloud, in my house, and in my
pocket.
* cloud backups of music files, a centralised copy of the database
* a complete local copy and player running on a raspberry pi/Mac
* iOS app player that can sync subsets of the library for offline playing
## Raspberry Pi requirements
Minimum install to get music files playing on Raspberry Pi (raspbian):
sudo apt-get -y install \
gstreamer1.0-alsa \
gstreamer1.0-plugins-good \
gstreamer1.0-plugins-bad \
gstreamer1.0-plugins-ugly \
python3-gst-1.0 \
redis
# if using the NFC HAT to trigger music, first configure jumpers
# on it to communicate via UART:
# https://www.raspberrypi.com/news/read-rfid-and-nfc-tokens-with-raspberry-pi-hackspace-37/
sudo raspi-config
# Interface Options -> Serial Interface
# Login to console: NO
# Enable: YES
# ...or...
# /boot/config.txt: set "enable_uart=1"
# /boot/cmdline.txt: remove "console=serial0,115200"
## Usage
sudo pip install .
# to scrobble played tracks, set the environment vars:
export LASTFM_KEY=...
export LASTFM_SECRET=...
export LASTFM_USER=...
export LASTFM_PASS=...
# to play a single track then exit
deck play track.mp3
# to play indefinitely from the redis queue
deck spin
# to make the indefinite player exit
deck quit
# to queue up music
deck queue track.mp3 [...]
deck queue --prepend track.mp3 [...]
# ...or with playlists
deck queue favourites.m3u
# ...or directories (to traverse and queue all music below)
deck queue Barenaked\ Ladies/
# ...or by listing files/playlists/dirs to stdin
echo track.mp3 | deck queue -
# to remove tracks from the queue
deck queue --remove track.mp3 [...]
# to clear the entire queue
deck queue --clear
# to replace the entire queue
deck queue --clear track.mp3 [...]
# to play something then return to the queue
deck interrupt track.mp3
# controls
deck pause
deck next
deck previous
deck skip
deck stop
# monitor previous, current, and queued tracks
deck show-previous [--repeat ]
deck show-playing [--repeat ]
deck show-queue [--repeat ]
deck show-summary [--repeat ]