OneLibraryCompanion v0.3.0 — preview

OneLibraryCompanion 0.3.0

Changes since the published Mac/Raspberry Pi 0.2.3 preview.

Automatic discovery and local USB loading

• Choose Automatic discovery in MENU to find CDJs on the local network. OLC reports the selected interface and searches again after network changes or disconnection. Manual IP connections and explicit interface selection remain available.
• Local OneLibrary USB loading now works through automatic discovery for players 1 and 2. Leave player number 4 free for OLC; Mac serving still requires Local USB Support. One local library is served per connection session.
• Overlapping load requests to the same player are rejected. OLC displays the local USB label for its served tracks.

Browser audio preview

• Open PLAY in track details or hold a track title to open the browser player. Audio plays on the browser device, independently of the physical CDJs.
• The popup includes play/pause, waveform seeking, artwork, time, BPM, key, genre, My Tags, comments and library color. Exported phrase sections and hot/memory cue markers appear when available.
• Audio streams from host-attached or linked CDJ libraries, subject to browser format support. Local AIFF/AIFC files receive a temporary 44.1 kHz/16-bit WAV copy; original USB files and CDJ serving are unchanged.
• Analysis previews now cover local and automatically discovered sources, combine DAT/EXT/2EX records, and retain valid cues and phrases when waveform data is missing.

Automatic set capture

• Capture runs on the host without pressing Start set. More than 45 seconds of continuous playback or looping qualifies a track; browser preview is excluded.
• More than five minutes without playback across the observed decks saves the session. Long tracks keep the session open; empty sessions are discarded.
• Split set here separates performances, Finish set saves immediately, and Join previous set joins adjacent captured sessions while preserving edited track orders.
• Start timestamps and repeat plays are retained. Short pauses, observation outages and restart recovery are handled without unnecessarily duplicating entries; uncertain observation boundaries are noted.

See the set history guide for qualification, recovery and editing details.

Headless Pi controls

• MENU offers confirmed Restart OLC, Shut down host and Unmount USB controls on the packaged Linux user service.
• Restart and shutdown block loaded OLC USB tracks unless fresh player status confirms they are stopped. Confirmation messages explain the emergency-loop and track-reload risk.
• USB unmounting briefly stops OLC, handles mounted partitions together, reports completion and never forcibly unmounts a busy volume. Devices containing system mounts are excluded.
• Shutdown and USB unmounting require the permissions described in the installation guide.

Connection reliability

• Fixed a post-load disconnection caused by repeatedly copying cached waveform assets. Assets are cached once per track identity and serving packets drain without rebuilding the UI snapshot for every packet.
• Failed USB analysis reads retry automatically, and the host records the last disconnection reason and timestamp for diagnostics.

Other performance and reliability improvements

• Lossless packed waveform transfers reduced sampled responses by approximately 93%, with older uncompressed clients still supported.
• Progress-aware downloads tolerate slow transfers, cancel superseded tracks, retry failures and display completed analysis promptly.
• Relative beat-phase refinement supports eligible normal forward non-master playback. Small timing corrections are smoothed; known loops use circular correction while preserving wraps. Relative refinement excludes loops, reverse and manual motion; physical accuracy remains to be fully validated.
• MENU can show recent waveform frame/drawing measurements and position-jump counts. iPad Safari supports launching OLC from a Home Screen icon without browser tabs or its address bar.
• Updated Pi packaging, network capabilities, dependencies, regression checks and setup documentation.

Downloads and setup

• Apple Silicon: OneLibraryCompanion-0.3.0-macos-arm64.dmg or .zip.
• Intel Mac: OneLibraryCompanion-0.3.0-macos-x86_64.dmg or .zip.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.3.0_arm64.deb and onelibrarycompanion_0.3.0_arm64.deb.
• Pi headless: install the host package, enable lingering and the user service, then open the Pi's network address from another device. Configure local USB mounting at boot.

Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. Reinstall Local USB Support after updating the Mac app.

Stop players using OLC-served tracks before updating packages or restarting the host. Keep OLC running, the host awake and the USB attached during playback.

Installation and headless setup · Local USB and transcoding · Compatibility and limits.

OneLibraryCompanion v0.2.3 — preview

OneLibraryCompanion 0.2.3

Menu cleanup

• Removed Offline preview from MENU and the disconnected status screen.

Browse refresh fixes

• Preserve list position and playlist/filter selections through same-library refreshes after loading.
• Keep the existing rows visible during background refreshes, and disable loading until fresh library data arrives.

Browse and navigation

• A larger CDJ STATUS / BROWSE toggle replaces the two separate buttons, using the same font size as the other navigation buttons. The active screen is highlighted; from MENU or SET HISTORY it returns to the last-used primary screen.
• BROWSE preserves list scroll position when returning from another screen. Changing collection, filters or sorting starts the new results at the top.
• Track titles currently playing on either connected deck appear in bright green immediately. Previously played titles retain softer green after qualifying playback.
• Screenshots use real exported waveform data for CDJ STATUS.

UI refinements

• Load diagnostics have moved out of the normal MENU.
• Local USB controls are embedded in the MENU panel; BROWSE retains its USB selector.
• Conversion-capable CDJ buttons stay white. CDJ STATUS shows the converted format and bit depth on one line.
• Audio target selection remains; conversion benchmark controls have been removed from MENU.
• Played-track titles turn green without set recording and persist until Clear played tracks is used in the SET HISTORY banner.

More music for older CDJs

Built-in audio transcoding lets older players such as the CDJ-2000nexus play supported local files they cannot decode directly, including FLAC and ALAC. Attach your OneLibrary USB to the Mac or Raspberry Pi, choose a track marked TRANSCODE NEEDED, and load it onto a stopped player. OLC prepares a compatible WAV or AIFF file before sending the load request.

• Automatic quality preservation or selectable 16-/24-bit WAV and AIFF output.
• Sample-rate conversion to 44.1 or 48 kHz when needed.
• Conversion progress, cancellation, prepared-file caching.
• Original USB files remain untouched; compatible tracks are sent as-is.
• Exported artwork, waveforms, beat grids, hot cues and memory cues accompany the track.
• Conversion runs inside OLC without additional audio software. It applies to host-attached USBs; linked CDJ USBs use their original files.

One library, two players

Serve one local OneLibrary USB per connection session to physical players 1 and 2, with original track IDs and compatible audio paths. Different tracks remain available to both decks. OLC checks the destination is connected, fresh and stopped before loading. Use Manual IP connections and leave player number 4 free for OLC.

OLC also provides two-deck live status, three-band waveforms, playlist browsing, combined metadata filters, harmonic key highlighting, and reusable set history with text, CSV and PDF exports. Native windows and LAN browsers share the same host.

Downloads and setup

• Apple Silicon: OneLibraryCompanion-0.2.3-macos-arm64.dmg or .zip.
• Intel Mac: OneLibraryCompanion-0.2.3-macos-x86_64.dmg or .zip.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.2.3_arm64.deb and onelibrarycompanion_0.2.3_arm64.deb.
• Pi headless: install the host package and enable its user service.

Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. On Mac, install Local USB Support from the application menu, then quit and reopen OLC. Reinstall this component after updating OLC. The Pi package grants the host its required port-binding capability.

Keep the host awake, OLC running and the USB attached throughout playback. Playback and cue controls remain on the physical CDJs. One local library can be served at a time; stop both players and reconnect OLC before switching libraries.

Matching source, license notices and SHA256 checksums accompany the installers. See the installation guide and compatibility for platform coverage and operating limits.

OneLibraryCompanion v0.2.2 — preview

OneLibraryCompanion 0.2.2

Browse refresh fixes

• Preserve list position and playlist/filter selections through same-library refreshes after loading.
• Keep the existing rows visible during background refreshes, and disable loading until fresh library data arrives.

Browse and navigation

• A larger CDJ STATUS / BROWSE toggle replaces the two separate buttons, using the same font size as the other navigation buttons. The active screen is highlighted; from MENU or SET HISTORY it returns to the last-used primary screen.
• BROWSE preserves list scroll position when returning from another screen. Changing collection, filters or sorting starts the new results at the top.
• Track titles currently playing on either connected deck appear in bright green immediately. Previously played titles retain softer green after qualifying playback.
• Screenshots use real exported waveform data for CDJ STATUS.

UI refinements

• Load diagnostics have moved out of the normal MENU.
• Local USB controls are embedded in the MENU panel; BROWSE retains its USB selector.
• Conversion-capable CDJ buttons stay white. CDJ STATUS shows the converted format and bit depth on one line.
• Audio target selection remains; conversion benchmark controls have been removed from MENU.
• Played-track titles turn green without set recording and persist until Clear played tracks is used in the SET HISTORY banner.

More music for older CDJs

Built-in audio transcoding lets older players such as the CDJ-2000nexus play supported local files they cannot decode directly, including FLAC and ALAC. Attach your OneLibrary USB to the Mac or Raspberry Pi, choose a track marked TRANSCODE NEEDED, and load it onto a stopped player. OLC prepares a compatible WAV or AIFF file before sending the load request.

• Automatic quality preservation or selectable 16-/24-bit WAV and AIFF output.
• Sample-rate conversion to 44.1 or 48 kHz when needed.
• Conversion progress, cancellation, prepared-file caching.
• Original USB files remain untouched; compatible tracks are sent as-is.
• Exported artwork, waveforms, beat grids, hot cues and memory cues accompany the track.
• Conversion runs inside OLC without additional audio software. It applies to host-attached USBs; linked CDJ USBs use their original files.

One library, two players

Serve one local OneLibrary USB per connection session to physical players 1 and 2, with original track IDs and compatible audio paths. Different tracks remain available to both decks. OLC checks the destination is connected, fresh and stopped before loading. Use Manual IP connections and leave player number 4 free for OLC.

OLC also provides two-deck live status, three-band waveforms, playlist browsing, combined metadata filters, harmonic key highlighting, and reusable set history with text, CSV and PDF exports. Native windows and LAN browsers share the same host.

Downloads and setup

• Apple Silicon: OneLibraryCompanion-0.2.2-macos-arm64.dmg or .zip.
• Intel Mac: OneLibraryCompanion-0.2.2-macos-x86_64.dmg or .zip.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.2.2_arm64.deb and onelibrarycompanion_0.2.2_arm64.deb.
• Pi headless: install the host package and enable its user service.

Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. On Mac, install Local USB Support from the application menu, then quit and reopen OLC. Reinstall this component after updating OLC. The Pi package grants the host its required port-binding capability.

Keep the host awake, OLC running and the USB attached throughout playback. Playback and cue controls remain on the physical CDJs. One local library can be served at a time; stop both players and reconnect OLC before switching libraries.

Matching source, license notices and SHA256 checksums accompany the installers. See the installation guide and compatibility for platform coverage and operating limits.

OneLibraryCompanion v0.2.1 — preview

OneLibraryCompanion 0.2.1

Browse and navigation

• A larger CDJ STATUS / BROWSE toggle replaces the two separate buttons, using the same font size as the other navigation buttons. The active screen is highlighted; from MENU or SET HISTORY it returns to the last-used primary screen.
• BROWSE preserves list scroll position when returning from another screen. Changing collection, filters or sorting starts the new results at the top.
• Track titles currently playing on either connected deck appear in bright green immediately. Previously played titles retain softer green after qualifying playback.
• Screenshots use real exported waveform data for CDJ STATUS.

UI refinements

• Load diagnostics have moved out of the normal MENU.
• Local USB controls are embedded in the MENU panel; BROWSE retains its USB selector.
• Conversion-capable CDJ buttons stay white. CDJ STATUS shows the converted format and bit depth on one line.
• Audio target selection remains; conversion benchmark controls have been removed from MENU.
• Played-track titles turn green without set recording and persist until Clear played tracks is used in the SET HISTORY banner.

More music for older CDJs

Built-in audio transcoding lets older players such as the CDJ-2000nexus play supported local files they cannot decode directly, including FLAC and ALAC. Attach your OneLibrary USB to the Mac or Raspberry Pi, choose a track marked TRANSCODE NEEDED, and load it onto a stopped player. OLC prepares a compatible WAV or AIFF file before sending the load request.

• Automatic quality preservation or selectable 16-/24-bit WAV and AIFF output.
• Sample-rate conversion to 44.1 or 48 kHz when needed.
• Conversion progress, cancellation, prepared-file caching.
• Original USB files remain untouched; compatible tracks are sent as-is.
• Exported artwork, waveforms, beat grids, hot cues and memory cues accompany the track.
• Conversion runs inside OLC without additional audio software. It applies to host-attached USBs; linked CDJ USBs use their original files.

One library, two players

Serve one local OneLibrary USB per connection session to physical players 1 and 2, with original track IDs and compatible audio paths. Different tracks remain available to both decks. OLC checks the destination is connected, fresh and stopped before loading. Use Manual IP connections and leave player number 4 free for OLC.

OLC also provides two-deck live status, three-band waveforms, playlist browsing, combined metadata filters, harmonic key highlighting, and reusable set history with text, CSV and PDF exports. Native windows and LAN browsers share the same host.

Downloads and setup

• Apple Silicon: OneLibraryCompanion-0.2.1-macos-arm64.dmg or .zip.
• Intel Mac: OneLibraryCompanion-0.2.1-macos-x86_64.dmg or .zip.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.2.1_arm64.deb and onelibrarycompanion_0.2.1_arm64.deb.
• Pi headless: install the host package and enable its user service.

Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. On Mac, install Local USB Support from the application menu, then quit and reopen OLC. Reinstall this component after updating OLC. The Pi package grants the host its required port-binding capability.

Keep the host awake, OLC running and the USB attached throughout playback. Playback and cue controls remain on the physical CDJs. One local library can be served at a time; stop both players and reconnect OLC before switching libraries.

Matching source, license notices and SHA256 checksums accompany the installers. See the installation guide and compatibility for platform coverage and operating limits.

OneLibraryCompanion v0.2.0 — preview

OneLibraryCompanion 0.2.0

More music for older CDJs

Built-in audio transcoding lets older players such as the CDJ-2000nexus play supported local files they cannot decode directly, including FLAC and ALAC. Attach your OneLibrary USB to the Mac or Raspberry Pi, choose a track marked TRANSCODE NEEDED, and load it onto a stopped player. OLC prepares a compatible WAV or AIFF file before sending the load request.

• Automatic quality preservation or selectable 16-/24-bit WAV and AIFF output.
• Sample-rate conversion to 44.1 or 48 kHz when needed.
• Conversion progress, cancellation, prepared-file caching and conversion benchmarks.
• Original USB files remain untouched; compatible tracks are sent as-is.
• Exported artwork, waveforms, beat grids, hot cues and memory cues accompany the track.
• Conversion runs inside OLC without additional audio software. It applies to host-attached USBs; linked CDJ USBs use their original files.

One library, two players

Serve one local OneLibrary USB per connection session to physical players 1 and 2, with original track IDs and compatible audio paths. Different tracks remain available to both decks. OLC checks the destination is connected, fresh and stopped before loading. Use Manual IP connections and leave player number 4 free for OLC.

OLC also provides two-deck live status, three-band waveforms, playlist browsing, combined metadata filters, harmonic key highlighting, and reusable set history with text, CSV and PDF exports. Native windows and LAN browsers share the same host.

Downloads and setup

• Apple Silicon: OneLibraryCompanion-0.2.0-macos-arm64.dmg or .zip.
• Intel Mac: OneLibraryCompanion-0.2.0-macos-x86_64.dmg or .zip.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.2.0_arm64.deb and onelibrarycompanion_0.2.0_arm64.deb.
• Pi headless: install the host package and enable its user service.

Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. On Mac, install Local USB Support from the application menu, then quit and reopen OLC. Reinstall this component after updating OLC. The Pi package grants the host its required port-binding capability.

Keep the host awake, OLC running and the USB attached throughout playback. Playback and cue controls remain on the physical CDJs. One local library can be served at a time; stop both players and reconnect OLC before switching libraries.

Matching source, license notices and SHA256 checksums accompany the installers. See the installation guide and compatibility for platform coverage and operating limits.

OneLibraryCompanion v0.1.2 — preview

OneLibraryCompanion 0.1.2

OLC provides two-deck live status with three-band waveforms, library browsing and filtering, protected track loading, Pi-hosted OneLibrary USB playback, and persistent set history with text, CSV and PDF exports. Mac and Raspberry Pi desktop windows and LAN browsers share the same host.

Installers

• Apple Silicon: OneLibraryCompanion-0.1.2-macos-arm64.dmg.
• Intel Mac: OneLibraryCompanion-0.1.2-macos-x86_64.dmg.
• Raspberry Pi Desktop: install both onelibrarycompanion-host_0.1.2_arm64.deb and onelibrarycompanion_0.1.2_arm64.deb.
• Pi headless: install the host package and enable its user service.

Mac ZIP alternatives, matching source and SHA256SUMS.txt accompany the installers. Mac requires macOS 13+; Pi requires 64-bit Raspberry Pi OS Bookworm or later. Mac packages are ad-hoc signed and not notarized. Physical Pi, Intel and minimum-OS validation remains incomplete.

Local USB operation

Local browsing is available on Mac and Pi. Local playback is available on Pi, whose installer grants the host executable the port-binding capability needed for UDP 111. Mac-hosted playback is unavailable without a privileged networking helper, which this package does not include.

Use Manual IP connections to physical players 1 and 2, leaving player number 4 free for OLC. Up to three mounted OneLibrary USBs are available. OLC serves original audio and exported metadata/analysis, keeps independent tracks available to both decks, and returns complete audio reads within the network payload limit.

Keep the host awake, OLC running and the USB connected during playback. First-load discovery may require LINK on the target player. Check the displayed load result and physical cue position; OLC does not force a start position or retry an uncertain load automatically.

See the README for features and docs/distribution.md, docs/local-usb.md and docs/compatibility.md for usage and limits. License notices and source credits are included in source and application packages.

OneLibraryCompanion v0.1.1 — preview

OneLibraryCompanion 0.1.1 distribution preview.

• Fix false port-conflict errors on Macs with network filtering: startup now checks local socket ownership without connecting to network interfaces.

• Startup failures show the actual service log error.

• Use the full OneLibraryCompanion name in the application header.

• Shared 1280 × 800 interface and Rust service, with standalone Mac and Raspberry Pi windows and unauthenticated LAN access.

• Mac supports close-to-background, Dock reopening, Quit, file exports and optional login startup. Pi packages include desktop and optional headless modes.

Targets: macOS 13+ (Apple Silicon/Intel); Raspberry Pi OS Bookworm 64-bit or later. Physical Intel/older macOS/Pi touchscreen and network testing remains required. Initial Mac packages are ad-hoc signed and not notarized. See docs/distribution.md for installation, data migration and known limitations.

Downloads:

• Apple Silicon Mac: OneLibraryCompanion-0.1.1-macos-arm64.dmg.
• Intel Mac: OneLibraryCompanion-0.1.1-macos-x86_64.dmg.
• Raspberry Pi desktop: download BOTH onelibrarycompanion-host_0.1.1_arm64.deb and onelibrarycompanion_0.1.1_arm64.deb, then install them together with sudo apt install ./onelibrarycompanion-host_0.1.1_arm64.deb ./onelibrarycompanion_0.1.1_arm64.deb.
• Mac ZIP alternatives, a source archive and SHA256SUMS.txt are also provided.

These release assets are built and smoke-tested by GitHub Actions from the tagged source. They are preview builds pending the hardware checks above.

Full source credits and dependency license texts are included in the source and application bundles. The repository and release downloads remain private.

OneLibraryCompanion v0.1.0 — preview

Initial OneLibraryCompanion distribution preview.

• Shared 1280 × 800 interface and Rust service, with standalone Mac and Raspberry Pi windows and unauthenticated LAN access.
• Mac supports close-to-background, Dock reopening, Quit, file exports and optional login startup. Pi packages include desktop and optional headless modes.

Targets: macOS 13+ (Apple Silicon/Intel); Raspberry Pi OS Bookworm 64-bit or later. Physical Intel/older macOS/Pi touchscreen and network testing remains required. Initial Mac packages are ad-hoc signed and not notarized. See docs/distribution.md for installation, data migration and known limitations.

Downloads:

• Apple Silicon Mac: OneLibraryCompanion-0.1.0-macos-arm64.dmg.
• Intel Mac: OneLibraryCompanion-0.1.0-macos-x86_64.dmg.
• Raspberry Pi desktop: download BOTH onelibrarycompanion-host_0.1.0_arm64.deb and onelibrarycompanion_0.1.0_arm64.deb, then install them together with sudo apt install ./onelibrarycompanion-host_0.1.0_arm64.deb ./onelibrarycompanion_0.1.0_arm64.deb.
• Mac ZIP alternatives, a source archive and SHA256SUMS.txt are also provided.

These release assets are built and smoke-tested by GitHub Actions from the tagged source. They are preview builds pending the hardware checks above.

Full source credits and dependency license texts are included in the source and application bundles. The repository and release downloads remain private.