Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

rbxport

rbxport

rbxport is a music library management app inspired by rekordbox. It keeps its feature set deliberately small, aiming for a faster, simpler user experience.

Its scope is limited to library management, USB exporting, and PRO DJ LINK.

Project vision

The core vision of rbxport is fewer features.

Because rbxport is open source, you are free to fork it and build a version of rekordbox customized by the community. The core project does not aim to be that. A project that keeps adding features eventually becomes what rekordbox already is: full-featured DJ software. rbxport stays small on purpose. Any contribution that adds a feature is weighed carefully against this vision, and a good feature can still be declined.

Two commitments define what "small" must not cost:

  • Compatibility. rbxport aims to be fully compatible with the current version of rekordbox and all the hardware that rekordbox supports.
  • Performance. rbxport maintains its speed through a performance budget, defined in perf-budgets.json and enforced by pnpm budget and CI. See Development conventions.

If you want to propose a feature, read Feature proposals in the contributing guide first.

Tech stack

LayerTechnology
Desktop appTauri 2.
FrontendReact and TypeScript, with TanStack Virtual for track browsing.
BackendRust, with independent rbl-* crates for library, audio, export, and LINK logic.
DatabaseSQLCipher for rekordbox libraries and OneLibrary USB exports.
Build toolingVite, pnpm, and Cargo.
TestingVitest, Playwright, and Rust tests with temporary library fixtures.

See Architecture for the repository layout and how the frontend, desktop shell, and Rust crates fit together.

Start here

For a first look at the interface, use the browser with a mock library:

pnpm install
pnpm dev:web

This requires Node 24 and pnpm 10.17.1. It does not open an installed rekordbox library or require a Rust build. For desktop prerequisites and safe library setup, read Getting started.

Developer reading path

Read these in order to understand the project and make your first change:

  1. Getting started: prerequisites, run modes, and library safety.
  2. Architecture: repository map, crate responsibilities, IPC, and edit flow.
  3. Development conventions: code style, performance, translation, and evidence rules.
  4. Testing: checks, test setup, and what each result proves.
  5. Contributing: issues, branches, implementation, validation, and review.
  6. Debugging: logs, diagnostics, environment variables, and cleanup.
  7. Releases: versions, CI, packaging, and publication.

The documentation index also links to user guides and detailed analysis, USB-format, and hardware references.

Common commands

CommandPurpose
pnpm dev:webBrowser UI with the mock backend.
pnpm devDesktop app; can open your installed library. Read the safety guide first.
pnpm lintFrontend lint rules.
pnpm buildTypeScript check and production frontend bundle.
pnpm testVitest tests.
pnpm e2ePlaywright browser tests against the mock backend.
RB_LITE_TEST=1 cargo test --workspaceRust tests with installed-library writes refused.

License and trademarks

rbxport is GPL-2.0-or-later. See LICENSE and Licensing for bundled components and distribution terms. Third-party product names belong to their respective owners. rbxport is an independent project and is not affiliated with, endorsed by, or sponsored by their owners.

Disclaimer

rbxport is provided "as is", without warranty to the extent permitted by applicable law. Use it at your own risk and keep backups of your music library and USB drives. Unless required by applicable law or agreed to in writing, the authors and contributors are not liable for damages arising from using or being unable to use rbxport, including lost or corrupted data, equipment damage, or financial losses. See LICENSE for the full warranty and liability terms.

rbxport is an independent project and is not affiliated with, endorsed by, or sponsored by AlphaTheta or Pioneer DJ. References to rekordbox, PRO DJ LINK, and other products describe compatibility only. All trademarks and product names belong to their respective owners.

Special thanks

evanpurkhiser, Maddix, Morgan Page, nichi, profbx, Sean Tyas, shiz, syl, trancejesus, xorbxbx, and AlphaTheta.

关于 About

A focused music library manager inspired by rekordbox, with USB export and PRO DJ LINK. Built for a faster, simpler workflow.
alphathetadjlibrary-managementmusic-librarypioneer-djpro-dj-linkreactrekordboxrusttauritypescriptusb-export

语言 Languages

Rust61.6%
TypeScript34.1%
CSS2.6%
JavaScript1.3%
Shell0.1%
PowerShell0.1%
Python0.1%
Nix0.1%
NSIS0.0%
HTML0.0%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
1526
Total Commits
峰值: 431次/周
Less
More

核心贡献者 Contributors