https://github.com/evanpurkhiser/prolink-go

golang library to interface with Pioneers PRO DJ Link network
https://github.com/evanpurkhiser/prolink-go

cdj djm pioneer prolink

Last synced: about 1 month ago
JSON representation

golang library to interface with Pioneers PRO DJ Link network

• Host: GitHub
• URL: https://github.com/evanpurkhiser/prolink-go
• Owner: evanpurkhiser
• License: mit
• Created: 2016-11-25T11:57:27.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2022-10-24T06:45:16.000Z (almost 2 years ago)
• Last Synced: 2024-07-12T02:48:04.854Z (about 2 months ago)
• Topics: cdj, djm, pioneer, prolink
• Language: Go
• Size: 137 KB
• Stars: 72
• Watchers: 14
• Forks: 8
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## Pioneer PRO DJ LINK client

[![Build Status](https://github.com/evanpurkhiser/prolink-go/workflows/build/badge.svg)](https://github.com/evanpurkhiser/prolink-go/actions?query=workflow%3Abuild)

[![Go Report Card](https://goreportcard.com/badge/github.com/evanpurkhiser/prolink-go)](https://goreportcard.com/report/github.com/evanpurkhiser/prolink-go)

[![GoDoc](https://godoc.org/go.evanpurkhiser.com/prolink?status.svg)](https://godoc.org/go.evanpurkhiser.com/prolink)

This go library provides an API to the Pioneer PRO DJ LINK network. Providing

various interactions and event subscribing.

Massive thank you to [@brunchboy](https://github.com/brunchboy) for his work on

[dysentery](https://github.com/brunchboy/dysentery).

```go

import "go.evanpurkhiser.com/prolink"

```

### Basic usage

```go

network, err := prolink.Connect()

network.AutoConfigure(5 * time.Second)

dm := network.DeviceManager()

st := network.CDJStatusMonitor()

added := func(dev *prolink.Device) {

    fmt.Printf("Connected: %s\n", dev)

}

removed := func(dev *prolink.Device) {

    fmt.Printf("Disconected: %s\n", dev)

}

dm.OnDeviceAdded("", prolink.DeviceListenerFunc(added))

dm.OnDeviceRemoved("", prolink.DeviceListenerFunc(removed))

statusChange := func(status *prolink.CDJStatus) {

    // Status packets come every 300ms, or faster depending on what is

    // happening on the CDJ. Do something with them.

}

st.AddStatusHandler(prolink.StatusHandlerFunc(statusChange));

```

### Features

- Listen for Pioneer PRO DJ LINK devices to connect and disconnect from the

  network using the

  [`DeviceManager`](https://godoc.org/go.evanpurkhiser.com/prolink#DeviceManager).

  Currently active devices may also be queried.

- Receive Player status details for each CDJ on the network. The status is

  reported as

  [`CDJStatus`](https://godoc.org/go.evanpurkhiser.com/prolink#CDJStatus)

  structs.

- Query the Rekordbox remoteDB server present on both CDJs themselves and on

  the Rekordbox (PC / OSX / Android / iOS) software for track metadata using

  [`RemoteDB`](https://godoc.org/go.evanpurkhiser.com/prolink#RemoteDB). This

  includes most metadata fields as well as (low quality) album artwork.

- View the status of a DJ setup as a whole using the

  [`mixstatus.Processor`](https://godoc.org/github.com/evanpurkhiser/prolink-go/mixstatus#Processor).

  This allows you to determine the status of tracks in a mixing situation. Has

  the track been playing long enough to be considered 'now playing'?

### Limitations, bugs, and missing functionality

- [[GH-1](https://github.com/evanpurkhiser/prolink-go/issues/1)] Currently the

  software cannot be run on the same machine that is running Rekordbox.

  Rekordbox takes exclusive access to the socket used to communicate to the

  CDJs making it impossible to receive track status information

- [[GH-6](https://github.com/evanpurkhiser/prolink-go/issues/6)] To read track

  metadata from the CDJs USB drives you may have no more than 3 CDJs. Having 4

  CDJs on the network will only allow you to read track metadata through

  linked Rekordbox.