The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.
dub is a command-line tool built from the same Rust engine as the app. It
talks to the engine directly, without the Swift app or its bindings, which
makes it the place to test the engine, check a rig, and reproduce a problem
with numbers instead of by ear.It comes with the source. Build it with Cargo; the binary lands in
target/release/dub:
cargo build --release -p dub-cli./target/release/dub help
Examples
./target/release/dub play --realtime track.mp3./target/release/dub timecode-deck a.mp3 b.mp3 --device-profile "SL 3"./target/release/dub scope --input-channels 3,4 # live timecode inspector (TUI)./target/release/dub rip --help # rip a record side from the terminal./target/release/dub export --help # rekordbox XML / M3U8
--input-channels counts from 1. On a Serato SL 3, deck A is 3,4.
Subcommands
dub help prints every flag. In one line each:
Engine
Command
For
smoke
Check the engine starts and renders a block of silence.
rt-audit
Stress the render path with allocation checks on.
version
Print the engine and FFI versions.
play
Play one or two tracks through the engine, live or rendered to a WAV, with scheduled rate, gain, pause, seek and swap events.
analyze
Audit a rendered WAV for clicks: peak, RMS, DC, clipping and sample-to-sample jumps.
stretch-bench
Compare the time-stretch backends on CPU, pitch, transients and timbre.
Audio interface and timecode
Command
For
list-inputs
List the DJ audio interfaces Dub recognises.
list-outputs
List output devices.
levels
Live level meters per input channel.
capture
Record an input to a WAV.
measure-latency
Break down an output’s latency.
decode-timecode
Decode a recording of Serato or Traktor control vinyl offline and report what the decoder saw.
timecode-deck
Play tracks from control vinyl, one or two decks.
thru
Route a real record through the engine.
scope
A live timecode scope in the terminal.
calibrate
Calibrate the timecode decoder to your rig and save it.
Library
Command
For
import
Import a Serato, Traktor, rekordbox or iTunes library, or a folder, without the app.
export
Write the library or a crate to rekordbox XML or M3U8. See Export.
diagnose
Explain a track’s beat grid, waveform and BPM in one report.
Ripping vinyl
Command
For
rip
Record a vinyl side, split it, encode FLAC with tags, and import it analysed.
rip-tune
Replay a recorded side through the rip’s gap and auto-start gates, to tune their thresholds without a turntable.
rip-resplit
Split a side you already ripped again, from its lossless archive.
recognize
Name a rip’s tracks with AcoustID and MusicBrainz. Read-only unless you pass --apply.
recognize needs an AcoustID key, passed with --key or set in
$DUB_ACOUSTID_KEY. Keys are free at acoustid.org.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dub","description":"Timecode vinyl for scratch DJs and sound systems. The manual for Dub, the open-source DVS for macOS.","colors":{"primary":"#A8752F","light":"#D9A33A","dark":"#C49157"},"logo":{"light":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/light.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=c66e63054545147233df8bceb8bf885d","dark":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/dark.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=9de389f24e6e3bee1432836b0a806ae1"},"favicon":"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/favicon.png?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=822c249106c922f25eace67503dac857","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://github.com/kLOsk/dub/issues","label":"Report a bug"}],"primary":{"type":"github","href":"https://github.com/kLOsk/dub"}},"footer":{"socials":{"github":"https://github.com/kLOsk/dub"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Download","icon":"download","href":"https://github.com/kLOsk/dub/releases/latest"},{"anchor":"Source on GitHub","icon":"github","href":"https://github.com/kLOsk/dub"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dub-3ccc829c","hasAudioNarration":false,"actualSubdomain":"dub-3ccc829c","customDomains":[],"gitSource":{"type":"github","owner":"klosk","repo":"dub","deployBranch":"main","contentDirectory":"site","isPrivate":false,"mountPath":"","label":"","_id":"6afaf4dbdd50ae575c5bef20"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd6d63801696bcb625221d","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Manual","count":16},{"language":"default","tag":"Developers","count":6},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Library","count":4},{"language":"default","tag":"Playing","count":3},{"language":"default","tag":"Settings","count":2},{"language":"default","tag":"Prep and records","count":2},{"language":"default","tag":"Help","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"developers/cli","slug":"/developers/cli","pageMetadata":{"title":"The dub CLI","description":"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.","icon":"terminal","href":"/developers/cli"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`dub`}),` is a command-line tool built from the same Rust engine as the app. It\ntalks to the engine directly, without the Swift app or its bindings, which\nmakes it the place to test the engine, check a rig, and reproduce a problem\nwith numbers instead of by ear.`]}),`\n`,_jsxs(_components.p,{children:[`It comes with the source. Build it with Cargo; the binary lands in\n`,_jsx(_components.code,{children:`target/release/dub`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`cargo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` build`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --release`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -p`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` dub-cli`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` help`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`examples`,children:`Examples`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` play`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --realtime`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` track.mp3`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` timecode-deck`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` a.mp3`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` b.mp3`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device-profile`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"SL 3\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` scope`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --input-channels`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 3,4`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # live timecode inspector (TUI)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rip`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --help`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # rip a record side from the terminal`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./target/release/dub`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --help`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # rekordbox XML / M3U8`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--input-channels`}),` counts from 1. On a Serato SL 3, deck A is `,_jsx(_components.code,{children:`3,4`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`subcommands`,children:`Subcommands`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`dub help`}),` prints every flag. In one line each:`]}),`\n`,_jsx(Heading,{level:`3`,id:`engine`,children:`Engine`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Command`}),_jsx(_components.th,{children:`For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`smoke`})}),_jsx(_components.td,{children:`Check the engine starts and renders a block of silence.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rt-audit`})}),_jsx(_components.td,{children:`Stress the render path with allocation checks on.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`version`})}),_jsx(_components.td,{children:`Print the engine and FFI versions.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`play`})}),_jsx(_components.td,{children:`Play one or two tracks through the engine, live or rendered to a WAV, with scheduled rate, gain, pause, seek and swap events.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`analyze`})}),_jsx(_components.td,{children:`Audit a rendered WAV for clicks: peak, RMS, DC, clipping and sample-to-sample jumps.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stretch-bench`})}),_jsx(_components.td,{children:`Compare the time-stretch backends on CPU, pitch, transients and timbre.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`audio-interface-and-timecode`,children:`Audio interface and timecode`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Command`}),_jsx(_components.th,{children:`For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list-inputs`})}),_jsx(_components.td,{children:`List the DJ audio interfaces Dub recognises.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list-outputs`})}),_jsx(_components.td,{children:`List output devices.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`levels`})}),_jsx(_components.td,{children:`Live level meters per input channel.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`capture`})}),_jsx(_components.td,{children:`Record an input to a WAV.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`measure-latency`})}),_jsx(_components.td,{children:`Break down an output’s latency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`decode-timecode`})}),_jsx(_components.td,{children:`Decode a recording of Serato or Traktor control vinyl offline and report what the decoder saw.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`timecode-deck`})}),_jsx(_components.td,{children:`Play tracks from control vinyl, one or two decks.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`thru`})}),_jsx(_components.td,{children:`Route a real record through the engine.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`scope`})}),_jsx(_components.td,{children:`A live timecode scope in the terminal.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`calibrate`})}),_jsx(_components.td,{children:`Calibrate the timecode decoder to your rig and save it.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`library`,children:`Library`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Command`}),_jsx(_components.th,{children:`For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`import`})}),_jsx(_components.td,{children:`Import a Serato, Traktor, rekordbox or iTunes library, or a folder, without the app.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`export`})}),_jsxs(_components.td,{children:[`Write the library or a crate to rekordbox XML or M3U8. See `,_jsx(_components.a,{href:`/library/export`,children:`Export`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`diagnose`})}),_jsx(_components.td,{children:`Explain a track’s beat grid, waveform and BPM in one report.`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`ripping-vinyl`,children:`Ripping vinyl`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Command`}),_jsx(_components.th,{children:`For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rip`})}),_jsx(_components.td,{children:`Record a vinyl side, split it, encode FLAC with tags, and import it analysed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rip-tune`})}),_jsx(_components.td,{children:`Replay a recorded side through the rip’s gap and auto-start gates, to tune their thresholds without a turntable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`rip-resplit`})}),_jsx(_components.td,{children:`Split a side you already ripped again, from its lossless archive.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`recognize`})}),_jsxs(_components.td,{children:[`Name a rip’s tracks with AcoustID and MusicBrainz. Read-only unless you pass `,_jsx(_components.code,{children:`--apply`}),`.`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`recognize`}),` needs an AcoustID key, passed with `,_jsx(_components.code,{children:`--key`}),` or set in\n`,_jsx(_components.code,{children:`$DUB_ACOUSTID_KEY`}),`. Keys are free at acoustid.org.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"The dub CLI","description":"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.","icon":"terminal","href":"/developers/cli"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Examples","slug":"examples","depth":2,"children":[]},{"title":"Subcommands","slug":"subcommands","depth":2,"children":[{"title":"Engine","slug":"engine","depth":3,"children":[]},{"title":"Audio interface and timecode","slug":"audio-interface-and-timecode","depth":3,"children":[]},{"title":"Library","slug":"library","depth":3,"children":[]},{"title":"Ripping vinyl","slug":"ripping-vinyl","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"dub-3ccc829c","siteName":"Dub","title":"The dub CLI - Dub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T18:13:10.314Z","originalFileLocation":"developers/cli.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"The dub CLI - Dub\">\u003cmeta data-mint-head property=\"og:description\" content=\"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://dub-3ccc829c.mintlify.app/developers/cli\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dub-3ccc829c.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=The+dub+CLI\u0026amp;description=The+headless+dub+binary%3A+test+the+engine%2C+inspect+timecode%2C+rip+records+and+move+your+library+from+the+terminal.\u0026amp;theme=958ea07cad40b39620a45bca\u0026amp;signature=efa0d297f9863403263e887b3793e91d3b9ceee31082115545fd7ba9039aeb30\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"The dub CLI - Dub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dub-3ccc829c.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=The+dub+CLI\u0026amp;description=The+headless+dub+binary%3A+test+the+engine%2C+inspect+timecode%2C+rip+records+and+move+your+library+from+the+terminal.\u0026amp;theme=958ea07cad40b39620a45bca\u0026amp;signature=efa0d297f9863403263e887b3793e91d3b9ceee31082115545fd7ba9039aeb30\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/dub-3ccc829c/rHdSH-e6JXq9G7cR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A8752F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://dub-3ccc829c.mintlify.app/developers/cli\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/cli.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\",\"name\":\"Dub\",\"url\":\"https://dub-3ccc829c.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/logo/light.svg?fit=max\u0026auto=format\u0026n=yjsJ2nZv-7OeAFUs\u0026q=85\u0026s=c66e63054545147233df8bceb8bf885d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://dub-3ccc829c.mintlify.app#website\",\"name\":\"Dub\",\"url\":\"https://dub-3ccc829c.mintlify.app\",\"publisher\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://dub-3ccc829c.mintlify.app/developers/cli#webpage\",\"url\":\"https://dub-3ccc829c.mintlify.app/developers/cli\",\"name\":\"The dub CLI\",\"description\":\"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\",\"dateModified\":\"2026-11-16T18:13:10.314Z\",\"isPartOf\":{\"@id\":\"https://dub-3ccc829c.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/developers/cli#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://dub-3ccc829c.mintlify.app/developers/cli#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developers\",\"item\":\"https://dub-3ccc829c.mintlify.app/developers/build\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The dub CLI\",\"item\":\"https://dub-3ccc829c.mintlify.app/developers/cli\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://dub-3ccc829c.mintlify.app/developers/cli#article\",\"headline\":\"The dub CLI\",\"name\":\"The dub CLI\",\"description\":\"The headless dub binary: test the engine, inspect timecode, rip records and move your library from the terminal.\",\"url\":\"https://dub-3ccc829c.mintlify.app/developers/cli\",\"mainEntityOfPage\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/developers/cli#webpage\"},\"dateModified\":\"2026-11-16T18:13:10.314Z\",\"publisher\":{\"@id\":\"https://dub-3ccc829c.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://dub-3ccc829c.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dub\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Dub\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/cli.md","siteName":"Dub","nav":{"global":{"anchors":[{"anchor":"Download","icon":"download","href":"https://github.com/kLOsk/dub/releases/latest"},{"anchor":"Source on GitHub","icon":"github","href":"https://github.com/kLOsk/dub"}]},"tabs":[{"tab":"Manual","pages":[{"title":"Manual","href":""}]},{"tab":"Developers","groups":[{"group":"Developers","pages":[{"title":"Build from source","description":"Set up the toolchain, build Dub.app, and run the same checks CI runs.","icon":"hammer","href":"/developers/build"},{"title":"The dub CLI","icon":"terminal","href":"/developers/cli"},{"title":"How Dub is built","description":"The Rust crates, the rules for the audio thread, and the bridge to the Swift app, with links to the full engineering docs.","icon":"sitemap","href":"/developers/architecture"}]}]}]},"basePath":"","title":"The dub CLI - Dub","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}