An LMS Monitor For The Future
LyMonS version 0.3.0 | Built: 2026-02-27
OLED information display control program for piCorePlayer or other Raspberry Pi and Lyrion Music Server (formerly Logitech Media Server) based audio device.
Pre-compiled binaries for Raspberry Pi are available on the binaries branch:
- 32-bit (armv7) - Pi 3, 4, Zero 2 W: lymons-latest-pcp-armv7.tgz
- 64-bit (aarch64) - Pi 4, 5, 400: lymons-latest-pcp-aarch64.tgz
# Download for your Pi (32-bit example)
wget https://github.com/shunte88/LyMonS/raw/binaries/latest/lymons-latest-pcp-armv7.tgz
# Extract
tar xzf lymons-latest-pcp-armv7.tgz
# Install
cd lymons-*-pcp-armv7
sudo ./install.sh
# Configure
sudo nano /etc/lymons/lymons.yamlBuilding from source? See CROSS_COMPILE.md for cross-compilation instructions.
- Oled drivers loaded on demand - delete the ones you don't use and save space
- SVG are utilized enabling support on many different OLED displays
- Mono, Gray4, and Color supported - depending ondisplay you use
- SVG are lightweight external files, embeded graphic are not stored in memory
- Track details are displayed only when playing
- Display features independant scrolling of track details as required.
- When playing, remaining time can be displayed rather than total time
- Audio attributes, volume, sample depth, and sample rate are shown
- Player attributes, shuffle, repeat, and fidelity glyphs are shown
- A retro clock is displayed when the audio is paused or stopped.
- Display regions are utilized for alignment, text wrapping, and layout
- You can display current weather and time. Requires an API key
- Weather descriptions can be translated to any language, however the display of same is not fully supported, Japanese, Korean, Chinese, and cyrilic languages are not supported (TBD)
- Automatically sets the brightness of the display at dawn and dusk.
- Multiple audio visualization modes are supported
- Multiple visualization styles are supported
- If monitoring from a separate device animations can be displayed as the track plays
- Alternatively can also be displayed instead of a visualization as the track plays
- Written in Rust - robust and memory safe
Usage: LyMonS [OPTIONS] --name <name>
Options:
-v, --debug Enable debug log level
-N, --name <name> LMS player name to monitor
-W, --weather <weather> Weather API key,units,transl,latitude,longitude [default: ]
-z, --scroll <scroll> Text display scroll mode [default: cylon] [possible values: loop, loopleft, cylon]
-r, --remain Display Remaining Time rather than Total Time
-F, --font <font> Clock font to use [default: 7seg] [possible values: 7seg, holdeco, holfestus, noto, roboto, soldeco, solfestus, space1999]
-E, --eggs <eggs> Easter Egg Animation [default: none] [possible values: bass, cassette, ibmpc, moog, pipboy, radio40, radio50, reel2reel, scope, technics, tubeamp, tvtime, vcr, none]
--no-splash Skip splash screen (shown by default)
-k, --metrics Display device metrics
-c, --config <config> monitor config file [default: config.toml]
--i2c-bus <i2c-bus> I2C bus device path for OLED display (e.g., /dev/i2c-1) [default: /dev/i2c-1]
-d, --driver <driver> Display driver type for emulator, overrides config (ssd1306, ssd1309, ssd1322, sh1106, sharpmemory) [possible values: ssd1306, ssd1309, ssd1322, sh1106, sharpmemory]
-a, --viz <viz> Visualization, meters, VU, Peak, Histograms, and more [default: no_viz] [possible values: aio_hist_mono, aio_vu_mono, combination, hist_mono, hist_stereo, peak_mono, peak_stereo, vu_mono, vu_stereo, waveform_spectrum, no_viz]
-h, --help Print help
-V, --version Print version
LyMonS:
LMS monitor
Display LMS details and animations
Clock, Weather, Meters, and more
Supported OLED types:
SH1106
SSD1306
SSD1309
SSD1322
SHARP-memory
OLED Clock Fonts:
7seg ........: Classic LCD Clock Font
soldeco .....: Deco-Solid Font
holdeco .....: Deco-Hollow Font
holfestus ...: Festus Hollow 25x44
solfestus ...: Festus Solid 25x44
space1999 ...: Space 1999
roboto ......: Roboto Thin
solnoto .....: noto 25x44
holnoto .....: noto fancy 25x44
Several visualizer modes are supported
- Stereo VU Meters - dBfs metered
- Stereo 12-band Spectrum Analysis
- Stereo 20-band Spectrum Analysis for wide displays
- Stereo Peak Meter - dBfs metered
- Downmix (visual data only) Peak Meter
- Large Downmix (visual data only) VU meter
- Large Downmix (visual data only) Spectrum
- All-In-One - track details and spectrum/VU "swoosh" - other keywords to come
- All-In-One - fixed mode - other keywords to come
- Wave Forms - wigly waves - coming soon
- Easter Eggs - fixed mode (use --egg <>)
There are two modes of operation:
- LyMonS installed on piCore Player, consuming visualization data directly
- LyMonS installed on an alternate device, the LMS Server for example, consuming streamed visualization data
If you are intending to consume visualization data you need to configure squeezelite to expose the shared memory
From the Squeezlite page of the pCP web frontend type 1 in the "m" ALSA parameter section
And, in the Various Options add -v
See the squeezelite page for more details
There are several "easter egg" modes provided for those setups that cannot process the audio data for visualization. That said theres nothing stopping you using them as your main visualization.
There are currently 7 easter egg modes:
- [cassette] Compact Cassette, as visually correct as possible given the OLED limitations. Hubs turn and the tape llops from one hub to the other with the tape window showing the track "progress"
- [technics] Technics SL-1200, as visually correct as possible given the OLED limitations. Tone arm traverses platter to indicate progress.
- [reel2reel] Open Reel To Reel, pure fantasy. Reels rotate, minor animation.
- [vcr] VCR with flashing 12:00 AM clock! No additional animation - the clock is annoying enough.
- [radio40] An large ornate radio. Minor animation, radio changes station as track progresses.
- [radio50] An old bakelite radio. Minor animation, radio changes station as track progresses.
- [tvtime] An old analog TV in all its 5x4 glory... VHF or UHF... no a dancing news reader
- [pctime] A crusty old IBM PS/2 clone... simple starfield animation just for fun
- [bass] A rubbish bass guitar - and why not...
- [pipboy] Its pipboy...
Specify --egg to display eggs on track playback
These are just a fun display mode where visualization is not possible.Team Badger shirts and other goodies are available at shunte88