navidrome / website

Navidrome's documentation website
https://www.navidrome.org
Apache License 2.0
18 stars 92 forks source link

MacOS installation instructions incomplete #164

Open michaelfairchild opened 4 days ago

michaelfairchild commented 4 days ago

Ensure these are in opt/navidrome folder

•   navidrome — Binary Program File
•   navidrome.log  — Logging Details 
•   navidrome.toml — Custom Configuration

navidrome.log - Blank plain text file (.log) navidrome.toml - Config options plain text file (.toml)

navidrome.toml Example


LogLevel = 'DEBUG' ScanSchedule = '@every 24h' TranscodingCacheSize = '150MiB'

This is path for your music library

MusicFolder = '/Users/USERNAME/Music/Navidrome-Subsonic-client/Music-Library'

This is the path for Navidrome library data

DataFolder = '/Users/USERNAME/Music/Navidrome-Subsonic-client/Navidrome-FIles/Data'

This is the path for Navidrome temporary files

CacheFolder = '/Users/USERNAME/Music/Navidrome-Subsonic-client/Navidrome-FIles/Cache'

This is the default path for Homebrew installed ffmpeg (Ensure actual file not symlink version)

FFmpegPath = '/usr/local/Cellar/ffmpeg/7.0_1/bin/ffmpeg'


Create pList

sudo vim /Library/LaunchAgents/navidrome.plist

Enter pList details from Navidrome


<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">

Label navidrome ProgramArguments /opt/navidrome/navidrome -c /opt/navidrome/navidrome.toml RunAtLoad StandardOutPath /opt/navidrome/navidrome.log StandardErrorPath /opt/navidrome/navidrome.log

To save a file in Vim

Press — Esc Type — :wq! Press — Enter

Edit access for the pList file

sudo chmod 644 /Library/LaunchAgents/navidrome.plist


CODE TO RUN AS BACKGROUND SERVICE


Ensure linking to main /Library not ~/Library (active user specific)

Load Service

launchctl load /Library/LaunchAgents/navidrome.plist

Start the service

launchctl start navidrome

End the service

launchctl stop navidrome

Unload Service

launchctl unload /Library/LaunchAgents/navidrome.plist


Ensure service is active

Check Local Webservice

http://localhost:4533

Check Launchlist

launchctl list | grep navidrome

Checking the log file

"/opt/navidrome/navidrome.log"