OneLibrary - What is it & how does it work?

What is OneLibrary?

For the latest information on OneLibrary, please refer to linked FAQ

OneLibrary is a universal DJ library database format developed in close collaboration with AlphaTheta. It is designed to standardise DJ performance data, including playlists, cue points, and beatgrids. This allows DJs to perform seamlessly across different software and hardware ecosystems.

With OneLibrary, you can seamlessly move your library between djay, rekordbox, and supported DJ hardware such as CDJ, XDJ, OPUS, and OMNIS systems.

With OneLibrary, you can:

  • Move your playlists, cue points and beatgrids easily between djay on different devices — solving one of the biggest pain points for DJs managing multiple setups.
  • Export your music library to a USB drive or SD card for use on professional DJ hardware, giving you maximum flexibility.

OneLibrary gives you complete flexibility — whether performing with djay on your laptop, or iOS device, or playing on supported hardware in the booth.

Key features

  • Add, delete, and edit playlists directly in OneLibrary (macOS / Windows).
  • Add tracks and playlists from My Collection, My Files, or External Apps.
  • Drag and drop tracks directly from Finder into OneLibrary (macOS).
  • Exported OneLibrary drives are compatible with:

Note: OneLibrary is only compatible with devices that support OneLibrary, currently the four hardware models listed above.

Cues, Loops & Beatgrids

djay automatically exports cue points, loops, and beatgrids to your OneLibrary drive. When you play a track from OneLibrary in djay, the app reads cue points, loops, and beatgrids directly from the drive. Any changes you make — such as setting new cue points or loops — are saved back to OneLibrary on the drive, ensuring your performance data stays in sync across all supported systems.

Supported drives & file systems

  • FAT32 — macOS / Windows / iOS
  • exFAT — macOS / Windows / iOS
  • HFS+ — macOS / iOS

How to create a new OneLibrary playlist or folder

  1. Connect a USB drive to your Mac.

  2. Go to the sidebar and click the USB Library icon.

  1. You’ll need to give OneLibrary access to the USB drive if it’s the first time using it.

  2. Choose the drive where you want to add playlists or folders.

  3. Click the + button to add a new playlist or folder.

6**.** You can now drag and drop music or files from your collection into your new playlist or folder in OneLibrary.

Note: Copying playlists and track information to OneLibrary may take some time, depending on file sizes.

Adding existing playlists or folders to OneLibrary

  1. Connect a USB drive to your Mac.

  2. Go to the sidebar and click My Collection.

  3. Right-click on an existing playlist and select Add to USB Library.

  1. The playlist will now appear in OneLibrary.

Alternatively, use Split Library mode to drag and drop playlists and folders directly to OneLibrary.

Notes & troubleshooting

  • If your drive does not appear, confirm the file system (exFAT / FAT32 / HFS+) and that the drive is mounted by the OS.
  • On iOS, because OneLibrary is read-only, export and editing must be performed on macOS or Windows.
  • When moving a OneLibrary drive between platforms, always eject/unmount the drive safely before unplugging.
7 Likes
2 Likes

Posted on another thread, it seems this is also the closest thing DJs pro users have to syncing djay pro playlists across their own devices (iPhone/ipad/macbook)

1 Like


Looks like OneLibrary will be a two-way street for laptop & desktop DJ software but iOS is a one-way destination. And the newly supported club gear can write and edit OneLibrary - so I wonder if we see entry level gear that can also read/write to OneLibrary, something like a OneLibrary FLX4.

1 Like

@eyeseeyou01 and @Michael_Wisniewski, I’ve moved your comments to this topic.

2 Likes

Sheesh.they need to fix that read only limitation on iOS devices. I primarily use my iPad for djay pro and then use my phone to review tracks when I’m mobile.

2 Likes

We cannot directly sync Apple Music playlists to OneLibrary USBs. We have have to move to My Collection first then to OneLibrary.

You have to delete the playlist in the OneLibrary drive if you have updates as far as I can tell.
I am also using Apple Local Music as my source. Works perfect across Mac and IOS.
This update is not for us I think.

3 Likes

While I wish the integration with Apple Music was more streamlined - I am really excited about all this. It makes it a lot easier to go from djay Pro to club gear and back.

  • For older club hardware, we can still create traditional USBs using OneLibrary in Rekordbox - with the added benefit of preserving the metadata from djay Pro. So that’s cool.

Practically it means managing 2x sets of USBs:

  • A set of OneLibrary USBs from djay Pro, mainly as backup
  • A set of traditional USBs from Rekordbox for compatibility with older club hardware.
1 Like

is this supported external drives?
macOS has been using APFS for SSDs since 2017isH

1 Like
  1. OneLibrary does not see any of my external APFS SSDs.
  2. But it immediately recognizes any FAT32 drives!
  3. And the APFS SSDs show up in ‘My Files’ where I can add tracks/playlist directly from the SSDs to OneLibrary.

So yes, looks like we have to use one of those file systems to use OneLibrary.

1 Like
  • The older version of OneLibrary is called Device Library.
  • Device Library USBs can still be created in Rekordbox for use on older club gear.
  • New club gear only works with OneLibrary USBs; and is not backward compatible.
  • CDJ-3000 is the lone device that accepts both Device Library and OneLibrary USBs.

USB Compatibility List

2 Likes

Thanks for sharing @Michael_Wisniewski

Maybe I missed the memo, but why are you limiting the iOS users to the read only mode?

It’s like an Alpha/Theta thing or technical limitation?

1 Like

Hi @DjEnvo, welcome to the Community! We don’t have any information to share regarding this at the moment.

LOL, sure you don’t have any information in this regard… :smiley:

FYI for anyone using CDJ 3000’s:

1 Like