Beatport Acquire

The beatport-acquire plugin logs into your Beatport account and downloads tracks you have already purchased — or marks unpurchased tracks as needing purchase, adding them to the Kombiner cart UI so you can buy them in one batch on Beatport’s website.

Plugin version: 0.2.3 | Stage: Acquire | Requires browser: Yes

Configuration

Setting	Type	Default	Description
username	string	—	Your Beatport account email or username
password	password	—	Your Beatport account password (stored encrypted)
formats	string	`AIFF,WAV,FLAC`	Comma-separated list of preferred formats in priority order

Format selection

The formats setting is a comma-separated list. The plugin tries each format in order and downloads the first one available. The default priority is:

AIFF — uncompressed, preferred by many DJs for highest quality
WAV — uncompressed, widely compatible
FLAC — lossless compressed, smaller file size

You can reorder or restrict this list. For example, FLAC,MP3 will always try FLAC first and fall back to MP3. Common Beatport format identifiers: AIFF, WAV, FLAC, MP3.

How It Works

For each track in the acquire cart:

The plugin logs into beatport.com using your credentials (once per run).
Checks whether the track is in your My Downloads page — i.e. whether you have already purchased it.
If purchased: Downloads the file in your highest-priority available format. The file is saved to your configured music directory and the track’s file_path field is updated.
If not purchased: Reports the track as purchasable by calling track_report_purchasable with the Beatport track URL and current price. The track appears in the Kombiner cart UI as a “needs purchase” item.

The browser session is kept alive for the entire run.

The Purchasable Flow

When a track is not yet purchased, the plugin marks it in the cart with a Needs Purchase status and attaches the Beatport track URL. From the Kombiner cart, you can:

Review which tracks need purchasing and at what price and add them to your Beatport cart
Click Open Beatport Cart to go directly to https://www.beatport.com/cart and complete the transaction in your browser
Or click Buy Now to purchase without leaving the Kombiner app
After purchasing manually on Beatport, click Download — the tracks will now appear in My Downloads and will be downloaded automatically

This flow lets you batch-review what you need to buy before spending money.

Acquire Statuses

Status	Meaning
downloaded	File successfully downloaded and saved
purchasable	Track found but not yet purchased; added to cart as a buy candidate
not_found	No Beatport link on the track (run Beatport Enrich first)
error	Login failure, network error, or unexpected page structure

Tips

Download your whole purchase history in one go. If you have many previously purchased tracks in your library, a single acquire run will download all of them without any manual intervention.
Adjust format priority to match your DJ setup. Rekordbox and Serato both handle AIFF and WAV natively. If you’re tight on disk space, put FLAC first.

Troubleshooting

Login fails Check your username and password in plugin settings. If your account uses two-factor authentication, the plugin will call browser_prompt() to show you the browser so you can complete the 2FA step.

Downloaded files are in the wrong format Verify your formats setting. The formats must match Beatport’s identifiers exactly (case-sensitive): AIFF, WAV, FLAC, MP3. If the requested format is not available for a specific track, the plugin moves on to the next option in your list.

Track is marked “needs purchase” but I did buy it Beatport sometimes takes a few minutes for a new purchase to appear in My Downloads. Wait a moment and re-run the plugin.