v0.1.3

• I2C bus speed in the Connection section: 100 kHz (the Pi's default), 400 kHz (what the controllers are specified for) or 1 MHz (beyond it; many modules take it). At 100 kHz a 128x64 frame takes about 90 ms and the meter moves at 10 frames a second; at 400 kHz it moves at the daemon's 25. Written to /boot/userconfig.txt between the plugin's marks for the hardware buses (i2c_arm_baudrate, i2c_vc_baudrate); a restart is asked for. --probe prints each bus's clock.
• Meter across the panel in the Face section: the meter takes the full width and at least the upper half, the rows give way from the top (album, artist, the artist · album row, then the format text, the larger title, the gaps) until the rest fits. On a 128x64 panel that is 32 bars over the time and the title, mpd_oled's own arrangement; on a 256x64, 64 bars.
• ssd1309_128x64 verified on a 2.42" module over SPI (the first one-bit controller on the bench): the test picture to all four corners, the playing page at 25 fps, 1.1 ms a frame. Then over I2C at 0x3C on the header bus (the first I2C panel): 10.7 fps at 95 ms a frame, the 100 kHz bus's ceiling.

Support this project

Just OLED is free and open source, designed, built and maintained by one developer in his own time. If it has earned a place on your player, you can support its development:

• GitHub Sponsors: https://github.com/sponsors/foonerd
• Ko-fi: https://ko-fi.com/justanerd

Just OLED is provided as-is under the MIT licence. Sponsorship is a thank-you, not a purchase: it buys no priority, no features and no support agreement.

v0.1.2

• Colours for the colour panels: a Colours choice in the Face section with Classic (white, green bars with an amber top, red peak), Amber, Ice, Fire and White, or Custom with a colour picker for each of the title, the detail rows, the bars, the bars' top, the peak marks and the progress line. The boot, ready, pause and farewell texts take the theme too. A monochrome or greyscale panel keeps its own levels.
• Beside the time, the format text keeps to the volume and connection icons rather than floating mid-row.

Support this project

Just OLED is free and open source, designed, built and maintained by one developer in his own time. If it has earned a place on your player, you can support its development:

• GitHub Sponsors: https://github.com/sponsors/foonerd
• Ko-fi: https://ko-fi.com/justanerd

Just OLED is provided as-is under the MIT licence. Sponsorship is a thank-you, not a purchase: it buys no priority, no features and no support agreement.

v0.1.1

• The meter takes the room the rows leave. Turning off the sample rate and bit depth, or the track time, no longer leaves an empty row: the remaining items pack into one row, or into the end of the title row when only the volume and connection icons are left, and the meter grows by what is freed. A new choice, Track text, sets how many rows the track takes under the meter: compact (the default: the title under one row of artist and album), full (the title larger, the artist and the album on rows of their own, as before) or the title alone. On a 128x128 panel the default meter is half as tall again as it was; with everything off it has four fifths of the panel. On a wide panel the info column beside the meter is only as wide as its rows need, so a 256x64 shows 40 bars by default and 64 with the title alone.

Support this project

Just OLED is free and open source, designed, built and maintained by one developer in his own time. If it has earned a place on your player, you can support its development:

• GitHub Sponsors: https://github.com/sponsors/foonerd
• Ko-fi: https://ko-fi.com/justanerd

Just OLED is provided as-is under the MIT licence. Sponsorship is a thank-you, not a purchase: it buys no priority, no features and no support agreement.

v0.1.0

The first release, a pre-release: everything below is in, one module (the Waveshare 1.5" RGB OLED, SSD1351, on a Raspberry Pi 4) has been seen working, the other controllers are driven from their data sheets and wait for a bench.

• The face: what the panel shows while music plays is the user's choice: the spectrum, the stereo spectrum (left rising, right hanging), the spectrum with left and right level bars, the level bars alone, the track alone in larger type, or the spectrum across the whole panel. With it: the track's time as played and total, played, remaining or off; the sample rate and bit depth (a stream's bitrate) beside the volume and the connection; peak marks on or off; and a meter gain of -12 to +12 dB, since the tap reads the music before the volume control and so shows the recording's level, which quiet and loud masters set 20 dB apart. The standby page shows the time and date in the user's formats (the clock and date lists lcd1602-vumeter offers), the player's address when wanted, and goes dark after a chosen number of minutes or never. The settings page puts the face first, then standby, then the connection, then the messages.
• The playing page in mpd_oled's manner: the sample rate and bit depth, a volume wedge, the connection and its strength, the time played and the track's length, the album, the artist and the title scrolling when they do not fit, a progress line; laid out for a strip, a 64-row panel and a tall one.
• The four-bit grey controllers: SSD1327 (1.5" 128x128, 128x96, 96x96), SSD1322 and SSD1362 (256x64), SSD1325 (128x64) and SH1122 (256x64, row by row), each glass at its place in the controller's RAM, the SSD1322 taking its arguments as data and the others as commands, transcribed from the data sheets, u8g2's drivers and luma.oled. Described, not yet drawn on a module. SPI clocks per controller: Sino Wealth's at 4 MHz, Solomon Systech's at 8, the SSD1351 at 10.
• The one-bit controllers: SSD1306 and its relatives (SSD1305, SSD1309, SSD1315) in one burst over the glass's window, SH1106 and SH1107 a page at a time, each glass at its own place in the controller's RAM (the 64-column glasses 32 columns in, the 1.3" SH1106 two columns in, the SH1107 64x128 at COM offset 0x60), transcribed from the data sheets, u8g2's drivers and luma.oled. Described, not yet drawn on a module. The SH1107 128x64 (a 64x128 on its side) waits for the quarter turn.
• The daemon: the panel opened from the plugin's settings and kept open, the lifecycle texts (boot, ready, pause, shutdown, restart) in the player's life, the now-playing page with the title, the artist and the spectrum bars from the tap's ring, a level bar for DSD, the standby clock, a test picture and messages on request, the control socket the plugin talks to, --say, --ping. Verified on a Waveshare 1.5inch RGB OLED (SSD1351) on a Raspberry Pi 4.
• The evo fonts: the evo framework's text face rasterised into one-bit glyph tables at three sizes (SIL Open Font License 1.1, fonts/OFL-evo.txt), drawn by the canvas with no font code on the player.
• The display path: the library speaks to /dev/spidev*, /dev/i2c-* and /dev/gpiochip* through their ioctls directly (no helper libraries), keeps the frame in the controller's own pixel layout (one-bit pages, four-bit grey, RGB565) with an upside-down option, and drives the SSD1351 from its data sheet and the module vendor's reference sequence. just-oled --probe lists the machine's buses and chips beside the settings; just-oled --test puts the test picture on the configured panel.
• The audio tap: libjustoledtap.so (ALSA type justoledtap) passes every stream through byte for byte and measures it on a thread of its own, peak and RMS per channel and a spectrum bank of up to 256 log, mel or linear bands with a peak hold and onsets, DSD and DoP by density, into a ring under /dev/shm. The tap descends from glass's; the FFT and the ring layout are this project's own.
• The library's own JSON reader for Volumio's configuration store and its own radix-2 FFT, so the only external crate is libc.
• The workspace: the justoled library with the tap and display features, the justoled-tap ALSA plugin and the just-oled daemon, libc the only external crate, enforced by the check.
• The catalogue of controllers and panels the daemon will drive, with just-oled --list and --list --json.
• The Volumio plugin's shape: settings page (connection, messages), the ALSA contribution, the service unit, install and uninstall, the launcher.
• The build path: check, ship, package, the builder image, CI and release workflows.

Support this project

Just OLED is free and open source, designed, built and maintained by one developer in his own time. If it has earned a place on your player, you can support its development:

• GitHub Sponsors: https://github.com/sponsors/foonerd
• Ko-fi: https://ko-fi.com/justanerd

Just OLED is provided as-is under the MIT licence. Sponsorship is a thank-you, not a purchase: it buys no priority, no features and no support agreement.