piratengine

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 19 Open GitHub ↗

Python open source tools for Denon DJ hardware

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# piratengine

## Description

This repository aims to provide 'low' level open source tools for **Denon DJ** hardware, in particular those using **Engine DJ OS**.

The first objective is to have simple tools to interact with m.db database.

Some features about StageLinQ will also be explored.

## Features

### Database2/m.db
 - [x] Qt GUI
 - [x] make a backup of the currently edited database
 - [x] read track, playlist info, ...
 - [x] test database modified with 2.20 schema 
 - [ ] test database modified with >=3 schema
 - [ ] track edit
 - [x] track add
 - [ ] track IDV3 fill
 - [ ] delete playlist/track/playlist track
 - [ ] change track position in playlist
 - [ ] change playlist index
 - [x] playlist create
 - [x] playlist to txt/json/m3u file
 - [x] playlist add track
 - [x] playlist add track from txt/json/m3u file
 - [x] scan files on engine dj music files storage
 - [x] update Track table from file scan
 - [x] support different database versions ( in 3.3.0 track table has 1 more parameter ) (to be tested  fully assessed )

### StageLinQ
 - [x] basic implementation of [PyStageLinQ](https://github.com/Jaxc/PyStageLinQ)
 - [x] grab stagelinq data 
 - [ ] use fileTransfer service
 - [ ] act as an instance of EngineDJ software

## Requirements
 - python 3
 - pip
 - Qt 6

## Installation
 - download release or build binary
 - extract files in the desired folder (binary and data files must stay in the same directory)
 - user files (config file,log,backups) are in `~/.config/piratengine` (unix) or `$HOME\Documents\piratengine` (windows)

## Running
 - double click on `piratengine`. 
 - Runnng `piratengine --nogui` will run the program in interactive terminal mode (no Qt Gui)

## Build
 - `git clone` the repo
 - `cd piratengine`
  <details>
    <summary>Linux</summary>

- run `./utils/build_linux.sh`</details>
  <details>
    <summary>Windows </summary>

- In a powershell, run `.\utils\build_windows.ps1`

</details>

- A zip file will be created with all needed application files. You can destroy all other files/folder.

## Utilities

Some useful ressources:

- [SQL3 database editor](https://sqlitebrowser.org/dl/) to manually read/edit databases
 - [Denon stuff](https://support.denondj.com/en/support/solutions/articles/69000834165-engine-dj-v3-0-support-for-third-party-database-tools)
 - [Wireshark](https://www.wireshark.org/download.html) for network packet capture & analysis
 - [StageLinq python Implementation](https://github.com/Jaxc/PyStageLinQ) 
 - [StageLinq nodeJs Implementation](https://github.com/MarByteBeep/StageLinq)
 - [StageLinq Beatinfo](https://github.com/dzelionis/denon-stageLinQ-BeatInfo)
 
## Compatibility
Linux, Mac, Windows (as in python)

Tested systems:

Fedora Linux, Archlinux, Windows 11

## Licensing
WTFPL.

**This stuff is provided as is with no warranty at all, take your own precautions before using it (database backup ...)**.

piratengine

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README