susan-scripts

Automation scripts for Susan (home server). Managed by Caine.

Scripts

Script	Purpose
overnight_transcoder.py	Nightly HEVC transcoding of video library
morning_report.py	Daily system health report (email)
music_recommender.py	Last.fm-based music discovery + Soulseek download
import_music.sh	FLAC→Opus transcoding + beets tagging for new albums
transcode_album.sh	Manual album transcode helper
scrape_discogs_labels.py	Scrape Discogs labels for music pipeline
generate_stats_page.py	Retro stats page generator
decrypt_bookmarks.js	Floccus bookmark decryption
add_bookmark.js	Add bookmark to Floccus XBEL
add_bookmark_to_wishlist.js	Add bookmark to wishlist folder

Setup

• Copy music_config.example.json to music_config.json and fill in credentials.
• Bookmark scripts read password from /etc/automation/bookmarks.json.