Media Management
- Music Player Daemon
- Audio Player
- Plex Television and Music Recordings
- Over-the-Air (OTA) HDHomeRun Television Recording
- curseradio
- Conclusion
This is where I manage Music and Television files.
Music Player Daemon
Hardware:
- BeagleBone AI-32 with Debian Linux
- TrueNAS container
Software:
- Linux: mpd (server), and mpc, ncmpcpp (clients)
$ sudo apt-get install mpd mpc
- iOS: MaximumMPD (client for iPhone, iPad)
MPD Configuration
File: /etc/mpd.conf
# An example configuration file for MPD.
# Read the user manual for documentation: http://www.musicpd.org/doc/user/
# or /usr/share/doc/mpd/html/user.html
# Files and directories #######################################################
#
# This setting controls the top directory which MPD will search to discover the
# available audio files and add them to the daemon's online database. This
# setting defaults to the XDG directory, otherwise the music directory will be
# be disabled and audio files will only be accepted over ipc socket (using
# file:// protocol) or streaming files over an accepted protocol.
#
music_directory "/data/bob/music/Music"
#
# This setting sets the MPD internal playlist directory. The purpose of this
# directory is storage for playlists created by MPD. The server will use
# playlist files not created by the server but only if they are in the MPD
# format. This setting defaults to playlist saving being disabled.
#
playlist_directory "/data/bob/music/mpd/playlists"
#
# This setting sets the location of the MPD database. This file is used to
# load the database at server start up and store the database while the
# server is not up. This setting defaults to disabled which will allow
# MPD to accept files over ipc socket (using file:// protocol) or streaming
# files over an accepted protocol.
#
db_file "/data/bob/music/mpd/tag_cache"
#
# These settings are the locations for the daemon log files for the daemon.
# These logs are great for troubleshooting, depending on your log_level
# settings.
#
# The special value "syslog" makes MPD use the local syslog daemon. This
# setting defaults to logging to syslog, or to journal if mpd was started as
# a systemd service.
#
log_file "/var/log/mpd/mpd.log"
#
# This setting sets the location of the file which stores the process ID
# for use of mpd --kill and some init scripts. This setting is disabled by
# default and the pid file will not be stored.
#
pid_file "/run/mpd/pid"
#
# This setting sets the location of the file which contains information about
# most variables to get MPD back into the same general shape it was in before
# it was brought down. This setting is disabled by default and the server
# state will be reset on server start up.
#
state_file "/data/bob/music/mpd/state"
#
# The location of the sticker database. This is a database which
# manages dynamic information attached to songs.
#
sticker_file "/data/bob/music/mpd/sticker.sql"
#
###############################################################################
# General music daemon options ################################################
#
# This setting specifies the user that MPD will run as. MPD should never run as
# root and you may use this setting to make MPD change its user ID after
# initialization. This setting is disabled by default and MPD is run as the
# current user.
#
user "mpd"
#
# This setting specifies the group that MPD will run as. If not specified
# primary group of user specified with "user" setting will be used (if set).
# This is useful if MPD needs to be a member of group such as "audio" to
# have permission to use sound card.
#
#group "nogroup"
#
# This setting sets the address for the daemon to listen on. Careful attention
# should be paid if this is assigned to anything other then the default, any.
# This setting can deny access to control of the daemon. Choose any if you want
# to have mpd listen on every address. Not effective if systemd socket
# activation is in use.
#
# For network
#bind_to_address "localhost"
bind_to_address "0.0.0.0"
#
# And for Unix Socket
#bind_to_address "/run/mpd/socket"
#
# This setting is the TCP port that is desired for the daemon to get assigned
# to.
#
port "6600"
#
# This setting controls the type of information which is logged. Available
# setting arguments are "default", "secure" or "verbose". The "verbose" setting
# argument is recommended for troubleshooting, though can quickly stretch
# available resources on limited hardware storage.
#
#log_level "default"
#
# Setting "restore_paused" to "yes" puts MPD into pause mode instead
# of starting playback after startup.
#
#restore_paused "no"
#
# This setting enables MPD to create playlists in a format usable by other
# music players.
#
#save_absolute_paths_in_playlists "no"
#
# This setting defines a list of tag types that will be extracted during the
# audio file discovery process. The complete list of possible values can be
# found in the user manual.
#metadata_to_use "artist,album,title,track,name,genre,date,composer,performer,disc"
#
# This example just enables the "comment" tag without disabling all
# the other supported tags:
#metadata_to_use "+comment"
#
# This setting enables automatic update of MPD's database when files in
# music_directory are changed.
#
#auto_update "yes"
#
# Limit the depth of the directories being watched, 0 means only watch
# the music directory itself. There is no limit by default.
#
#auto_update_depth "3"
#
###############################################################################
# Symbolic link behavior ######################################################
#
# If this setting is set to "yes", MPD will discover audio files by following
# symbolic links outside of the configured music_directory.
#
#follow_outside_symlinks "yes"
#
# If this setting is set to "yes", MPD will discover audio files by following
# symbolic links inside of the configured music_directory.
#
#follow_inside_symlinks "yes"
#
###############################################################################
# Zeroconf / Avahi Service Discovery ##########################################
#
# If this setting is set to "yes", service information will be published with
# Zeroconf / Avahi.
#
#zeroconf_enabled "yes"
#
# The argument to this setting will be the Zeroconf / Avahi unique name for
# this MPD server on the network. %h will be replaced with the hostname.
#
#zeroconf_name "Music Player @ %h"
#
###############################################################################
# Permissions #################################################################
#
# If this setting is set, MPD will require password authorization. The password
# setting can be specified multiple times for different password profiles.
#
#password "password@read,add,control,admin"
#
# This setting specifies the permissions a user has who has not yet logged in.
#
#default_permissions "read,add,control,admin"
#
###############################################################################
# Database #######################################################################
#
#database {
# plugin "proxy"
# host "other.mpd.host"
# port "6600"
#}
# Input #######################################################################
#
input {
plugin "curl"
# proxy "proxy.isp.com:8080"
# proxy_user "user"
# proxy_password "password"
}
# QOBUZ input plugin
input {
enabled "no"
plugin "qobuz"
# app_id "ID"
# app_secret "SECRET"
# username "USERNAME"
# password "PASSWORD"
# format_id "N"
}
# TIDAL input plugin
input {
enabled "no"
plugin "tidal"
# token "TOKEN"
# username "USERNAME"
# password "PASSWORD"
# audioquality "Q"
}
# Decoder #####################################################################
#
decoder {
plugin "hybrid_dsd"
enabled "no"
# gapless "no"
}
#
###############################################################################
# Audio Output ################################################################
#
# MPD supports various audio output types, as well as playing through multiple
# audio outputs at the same time, through multiple audio_output settings
# blocks. Setting this block is optional, though the server will only attempt
# autodetection for one sound card.
#
# An example of an ALSA output:
#
audio_output {
type "alsa"
name "Sabrent ALSA Device"
device "hw:1" # optional
# device "hw:0,0" # optional
# mixer_type "hardware" # optional
# mixer_device "default" # optional
# mixer_control "PCM" # optional
# mixer_index "0" # optional
}
#
# Bluetooth through pulesaudio
#audio_output {
# type “pulse”
# name “FOSI Audio”
# mixer_type “none”
# sink “bluez_sink.7C:58:CA:00:19:63.a2dp_sink”
#}
#
# An example of an OSS output:
#
#audio_output {
# type "oss"
# name "My OSS Device"
# device "/dev/dsp" # optional
# mixer_type "hardware" # optional
# mixer_device "/dev/mixer" # optional
# mixer_control "PCM" # optional
#}
#
# An example of a shout output (for streaming to Icecast):
#
#audio_output {
# type "shout"
# encoder "vorbis" # optional
# name "My Shout Stream"
# host "localhost"
# port "8000"
# mount "/mpd.ogg"
# password "hackme"
# quality "5.0"
# bitrate "128"
# format "44100:16:1"
# protocol "icecast2" # optional
# user "source" # optional
# description "My Stream Description" # optional
# url "http://example.com" # optional
# genre "jazz" # optional
# public "no" # optional
# timeout "2" # optional
# mixer_type "software" # optional
#}
#
# An example of a recorder output:
#
#audio_output {
# type "recorder"
# name "My recorder"
# encoder "vorbis" # optional, vorbis or lame
# path "/var/lib/mpd/recorder/mpd.ogg"
## quality "5.0" # do not define if bitrate is defined
# bitrate "128" # do not define if quality is defined
# format "44100:16:1"
#}
#
# An example of a httpd output (built-in HTTP streaming server):
#
audio_output {
type "httpd"
name "My HTTP Stream"
encoder "vorbis" # optional, vorbis or lame
port "8888"
bind_to_address "0.0.0.0" # optional, IPv4 or IPv6
#quality "5.0" # do not define if bitrate is defined
bitrate "128" # do not define if quality is defined
format "44100:16:1"
max_clients "2" # optional 0=no limit
}
#
# An example of a pulseaudio output (streaming to a remote pulseaudio server)
# Please see README.Debian if you want mpd to play through the pulseaudio
# daemon started as part of your graphical desktop session!
#
#audio_output {
# type "pulse"
# name "My Pulse Output"
# server "remote_server" # optional
# sink "remote_server_sink" # optional
#}
#
# An example of a winmm output (Windows multimedia API).
#
#audio_output {
# type "winmm"
# name "My WinMM output"
# device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
# or
# device "0" # optional
# mixer_type "hardware" # optional
#}
#
# An example of an openal output.
#
#audio_output {
# type "openal"
# name "My OpenAL output"
# device "Digital Audio (S/PDIF) (High Definition Audio Device)" # optional
#}
#
## Example "pipe" output:
#
#audio_output {
# type "pipe"
# name "my pipe"
# command "aplay -f cd 2>/dev/null"
## Or if you're want to use AudioCompress
# command "AudioCompress -m | aplay -f cd 2>/dev/null"
## Or to send raw PCM stream through PCM:
# command "nc example.org 8765"
# format "44100:16:2"
#}
#
## An example of a null output (for no audio output):
#
#audio_output {
# type "null"
# name "My Null Output"
# mixer_type "none" # optional
#}
#
###############################################################################
# Normalization automatic volume adjustments ##################################
#
# This setting specifies the type of ReplayGain to use. This setting can have
# the argument "off", "album", "track" or "auto". "auto" is a special mode that
# chooses between "track" and "album" depending on the current state of
# random playback. If random playback is enabled then "track" mode is used.
# See <http://www.replaygain.org> for more details about ReplayGain.
# This setting is off by default.
#
#replaygain "album"
#
# This setting sets the pre-amp used for files that have ReplayGain tags. By
# default this setting is disabled.
#
#replaygain_preamp "0"
#
# This setting sets the pre-amp used for files that do NOT have ReplayGain tags.
# By default this setting is disabled.
#
#replaygain_missing_preamp "0"
#
# This setting enables or disables ReplayGain limiting.
# MPD calculates actual amplification based on the ReplayGain tags
# and replaygain_preamp / replaygain_missing_preamp setting.
# If replaygain_limit is enabled MPD will never amplify audio signal
# above its original level. If replaygain_limit is disabled such amplification
# might occur. By default this setting is enabled.
#
#replaygain_limit "yes"
#
# This setting enables on-the-fly normalization volume adjustment. This will
# result in the volume of all playing audio to be adjusted so the output has
# equal "loudness". This setting is disabled by default.
#
#volume_normalization "no"
#
###############################################################################
# Character Encoding ##########################################################
#
# If file or directory names do not display correctly for your locale then you
# may need to modify this setting.
#
filesystem_charset "UTF-8"
#
###############################################################################
MPD Daemon Processes
These configurations keep the mpd daemon running after boot and restarted upon any failure.
Linux
FIle: /lib/systemd/system/mpd.service
[Unit]
Description=Music Player Daemon
Documentation=man:mpd(1) man:mpd.conf(5)
Documentation=file:///usr/share/doc/mpd/user-manual.html
After=network.target sound.target
[Service]
Type=notify
EnvironmentFile=/etc/default/mpd
ExecStart=/usr/bin/mpd --no-daemon $MPDCONF
# Enable this setting to ask systemd to watch over MPD, see
# systemd.service(5). This is disabled by default because it causes
# periodic wakeups which are unnecessary if MPD is not playing.
#WatchdogSec=120
# allow MPD to use real-time priority 50
LimitRTPRIO=50
LimitRTTIME=infinity
# disallow writing to /usr, /bin, /sbin, ...
ProtectSystem=yes
# more paranoid security settings
NoNewPrivileges=yes
ProtectKernelTunables=yes
ProtectControlGroups=yes
ProtectKernelModules=yes
# AF_NETLINK is required by libsmbclient, or it will exit() .. *sigh*
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX AF_NETLINK
RestrictNamespaces=yes
[Install]
WantedBy=multi-user.target
Also=mpd.socket
Audio Player
Hardware:
- host (BeagleBone AI-64 Debian Linux).
Software:
- Linux: NextCloud app called audioplayer, visible on NextCloud web interface
The music files reside in the /Music directory of the nextcloud account.
Reference: https://apps.nextcloud.com/apps/audioplayer
Plex Television and Music Recordings
This is where most TV shows are played from, on either one of the Apple-TVs.
Hardware:
- TrueNAS Scale container
Software:
- Debian: Plex Media Server app, Web Interface http://127.0.0.1:32400/web/index.html#!/
- iOS: Plexamp (Music) on the Phone or Tablet
- tvOS: Plex (Video, Music) on the Apple-TV
Libraries:
- TV: /tv_share/tv (Recordings come from OTA HDHomeRun below)
- Movies: ~/tv_share/movies
- Music: ~/nextcloud/Music
Reference: https://www.plex.tv/media-server-downloads/
Over-the-Air (OTA) HDHomeRun Television Recording
Hardware:
- host HDHomeRun (Silicondust Engineering Flex-4; https://www.silicondust.com/product/hdhomerun-flex-4k/) with 2TB USB SSD locally attached.
Software:
- Built-in webservice on port 80 (http://hdhomerun.local/)
- iOS: HDHomeRun (Used to set recordings and delete old shows on the HDHomeRun box)
- Application Programming Interface (API): https://info.hdhomerun.com/info/http_api
Copy TV Recordings
The actual recording from OTA happens on the HDHomeRun box, and I copy the recordings into a Plex library using the HDHomeRun web interface. This is scheduled once a day in cron.
File: ~/tv_share/tv/hdhomerun/get.sh
#!/bin/bash
#-------------------------------------------------
# File get.sh
# Usage: get.sh
# Set the IP address of the HDHomeRun Flex box
# with DVR USB disk attached
#
# Purpose: Copy recordings to the shared filesystem
# so they can be played by other software,
# i.e.: Plex, Infuse, VLC, etc...
#
# Dependencies:
# -apt install jq.
# -curl is installed by normal OS.
# -silicondust.com DVR subscription
# required to record on the device, $35 annual
# hdhomerun_config also from silicondust.com
#
# History:
# Date Author Description
# ----------- ---------- -----------------------
# 22-Jul-2021 Don Cohoon Created on MacOS
# 20-Jan-2023 Don Cohoon Added REAL_URL because
# firmware release kept ${IP} as file name causing
# of zero byte files
#-------------------------------------------------
MYHOME="/mnt/vol032"
MYDIR="tv_share/tv"
MYTESTFILE=${MYHOME}/tv_share/get.sh
export PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
#-------------------------------------------------
# Log
function logit()
{
echo $@
echo ${0} $(/bin/date) : $@ >>hdhomerun.log 2>&1
}
#-------------------------------------------------
# Ensure we move to correct directory
#
cd ${MYHOME}/${MYDIR}
if [ ! -f ${MYTESTFILE} ]; then
logit "=> Cannot change to ${MYHOME}/${MYDIR}"
exit 2
fi
#-------------------------------------------------
# Get IP address of TV Server
#
IP=$(/usr/local/bin/hdhomerun_config discover|awk '{print $6}')
logit "=> IP address of TV server is ${IP}"
#-------------------------------------------------
# Get Record engine status
#
logit "=> discover.json"
/usr/bin/curl -s http://${IP}/discover.json >discover.json 2>>hdhomerun.log
# ^
#cat discover.json
#logit
#logit ". . ."
#-------------------------------------------------
# Get recorded_files.json from root of dvr
#
logit "=> recorded_files.json"
/usr/bin/curl -s --header 'Accept: */*' \
--header 'Accept-Encoding: gzip, deflate' \
--header 'Accept-Language: en-US,en;q=0.5' \
--header 'Cache-Control: no-cache' \
--header 'Connection: keep-alive' \
--header 'Pragma: no cache' \
--header "Host: ${IP}" \
--header "Referer: http://${IP}/recorded_files.html" \
--header 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:89.0) Gecko/20100101 Firefox/89.0' \
http://${IP}/recorded_files.json?DisplayGroupID=root > recorded_files.json 2>>hdhomerun.log
# ^ ^ ^
#cat recorded_files.json
#logit
#logit ". . ."
#-------------------------------------------------
# Get root SeriesIDs from recorded_files.json
#
declare -a SeriesID
SeriesID=($(/usr/bin/jq -r '.[] | .SeriesID' recorded_files.json))
#for (( i = 0 ; i < ${#SeriesID[@]} ; i++))
#do
# logit "Series [$i]: ${SeriesID[$i]}"
#done
#-------------------------------------------------
# Get root Titles from recorded_files.json
#
declare -a Title
/usr/bin/jq -r '.[] | .Title' recorded_files.json > recorded_files.title
let i=0
while read t
do
# Add new element at the end of the array
Title+=("${t}")
logit "Title [$i]: ${Title[$i]}"
let i++
done < recorded_files.title
rm recorded_files.title
#
#-------------------------------------------------
# Get SeriesID recordings, into "Title"/recorded_files.json
#
for (( iSeriesID = 0 ; iSeriesID < ${#SeriesID[@]} ; iSeriesID++))
do
# Put Series into Title directory
mkdir -p "${Title[$iSeriesID]}"
cd "${Title[$iSeriesID]}"
logit "Downloading Series : ${Title[$iSeriesID]}/recorded_files.json"
/usr/bin/curl -s --header 'Accept: */*' \
--header 'Accept-Encoding: gzip, deflate' \
--header 'Accept-Language: en-US,en;q=0.5' \
--header 'Cache-Control: no-cache' \
--header 'Connection: keep-alive' \
--header 'Host: ${IP}' \
--header 'Pragma: no-cache' \
--header 'Referer: http://${IP}/recorded_files.html?SeriesID="${SeriesID[$iSeriesID]}"' \
--header 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:89.0) Gecko/20100101 Firefox/89.0' \
http://${IP}/recorded_files.json?SeriesID="${SeriesID[$iSeriesID]}" > recorded_files.json 2>>hdhomerun.log
# ^ ^ ^
#-------------------------------------------------
# Get all PlayURL recordings for this SeriesID
#
unset PlayURL
declare -a PlayURL
PlayURL=($(/usr/bin/jq -r '.[] | .PlayURL' recorded_files.json))
for (( iPlayURL = 0 ; iPlayURL < ${#PlayURL[@]} ; iPlayURL++))
do
logit "PlayURL [$iPlayURL]: ${PlayURL[$iPlayURL]}"
done
#-------------------------------------------------
# Get all Filename recordings for this SeriesID
#
unset Filename
declare -a Filename
/usr/bin/jq -r '.[] | .Filename' recorded_files.json > recorded_files.title
let iFilename=0
while read f
do
# Add new element at the end of the array
Filename+=("${f}")
if [ ! -f "${Filename[$iFilename]}" ]; then # New file, download it
logit "Downloading Filename [$iFilename]: ${Filename[$iFilename]}"
mail -s "HDHomeRun recording: Downloading Filename [$iFilename]: ${Filename[$iFilename]} - ${PlayURL[$iFilename]}" bob@example.com <<EOF
$(/bin/date)
EOF
#-------------------------------------------------
# Download Recording
#
REAL_URL=$(eval echo ${PlayURL[$iFilename]})
logit "RealURL: ${REAL_URL}"
/usr/bin/curl --header 'Accept: */*' \
--header 'Accept-Encoding: gzip, deflate' \
--header 'Accept-Language: en-US,en;q=0.5' \
--header 'Cache-Control: no-cache' \
--header 'Connection: keep-alive' \
--header 'Host: ${IP}' \
--header 'Pragma: no-cache' \
--header 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:89.0) Gecko/20100101 Firefox/89.0' \
"${REAL_URL}" > "${Filename[$iFilename]}" 2>>hdhomerun.log
# ^ ^
fi
#
let iFilename++
done < recorded_files.title
rm recorded_files.title
# Back to main directory
cd ..
done
curseradio
Python project to listen to streaming internet radio from command line
Files:
- ~/.local/share/curseradio/favourites.opml
- ~/radio.sh
#!/bin/bash
#sudo apt-get install curseradio
#git clone https://github.com/chronitis/curseradio/
## cd
cd curseradio
## create venv
#python3 -m venv env
## activate vene
source env/bin/activate
## install required libraries via requirements.txt file
# cat requirements.txt
#lxml
#requests
#pyxdg
## pip install
#pip install -r requirements.txt
## setup.py
# pip install -e .
##Obtaining file:///media/bob/data/curseradio
##Installing collected packages: curseradio
## Running setup.py develop for curseradio
##Successfully installed curseradio
##
## Run it!
curseradio
## Get out of virtual environment
deactivate
cursoradio configuration file
<outline type="audio" text="Handcrafted Radio (US)" URL="
http://opml.radiotime.com/Tune.ashx?id=s97491" bitrate="128"
reliability="98" guide_id="s97491" subtext="Jackson Browne - Doctor My
Eyes" genre_id="g54" formats="mp3" playing="Jackson Browne - Doctor My
Eyes" playing_image="http://cdn-albums.tunein.com/gn/WJRG9NQZCHq.jpg"
item="station" image="http://cdn-radiotime-logos.tunein.com/s97491q.png
" now_playing_id="s97491" preset_id="s97491"/>
...
from ~/.local/share/curseradio/favourites.opml
Conclusion
Now that you have sensed the sights and sounds of Video and Audio controlled and maintained by your computer, I wish to thank you for your interest in this book..
Hopefully this little write up was of some help.
Regards,
-- Don
Book Last Updated: 29-March-2024
Media (TV/Music) Management - Linux in the House - https://linux-in-the-house.org
