https://github.com/charlesfleche/lpd8editor

A linux editor for the Akai LPD8
https://github.com/charlesfleche/lpd8editor

Last synced: about 2 months ago
JSON representation

A linux editor for the Akai LPD8

• Host: GitHub
• URL: https://github.com/charlesfleche/lpd8editor
• Owner: charlesfleche
• License: mit
• Created: 2017-05-05T00:14:26.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-04-09T22:41:28.000Z (over 2 years ago)
• Last Synced: 2024-06-20T01:07:47.062Z (3 months ago)
• Language: C++
• Size: 953 KB
• Stars: 59
• Watchers: 7
• Forks: 5
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![test](https://github.com/charlesfleche/lpd8editor/actions/workflows/test.yml/badge.svg)](https://github.com/charlesfleche/lpd8editor/actions/workflows/test.yml) [![release](https://github.com/charlesfleche/lpd8editor/actions/workflows/release.yml/badge.svg)](https://github.com/charlesfleche/lpd8editor/actions/workflows/release.yml)

# lpd8editor

A Linux editor for the [Akai LPD8 pad controller](http://www.akaipro.com/product/lpd8).

![lpd8-editor screenshot](doc/screenshot.png?raw=true "lpd8editor")

## Prebuilt binaries

Check the [releases](https://github.com/charlesfleche/lpd8editor/releases) page for ready to use packages.

## Building

Building lpd8editor requires a C++-11 compiler, cmake, Alsa and Qt5 with its internationalization tools. The [Github actions](.github/workflows/release.yml) provides detailed step by step to install dependencies, build, test and release.

### Building from git clone

After dependencies are installed:

```bash

# Clone the code repository

git clone https://github.com/charlesfleche/lpd8editor.git

# Create the build directory

mkdir build-lpd8editor

cd build-lpd8editor

# Configure the build system

cmake ../lpd8editor -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/lpd8editor

# Build and install

cmake --build . --target install

# Run lpd8editor

~/lpd8editor/bin/lpd8editor

```

### Building from a compressed source folder

GitHub automatically publishes compressed source folders (.tar.gz or .zip archives) for each [release](releases). To build lpd8editor from those archives:

```bash

# In the following instructions, replace x.y.z by the actual version of the downloaded archive

# Extract the downloaded .tar.gz archive

tar xf lpd8editor-x.y.z.tar.gz

# Or, for a .zip

unzip lpd8editor-x.y.z.zip

# Create the build directory

mkdir build-lpd8editor

cd build-lpd8editor

# Configure the build system

cmake ../lpd8editor-x.y.z -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=~/lpd8editor

# Build and install

cmake --build . --target install

# Run lpd8editor

~/lpd8editor/bin/lpd8editor

```

### Running the tests

```bash

cmake --build . --target test

```

### Building the binary packages

```bash

# Packages will be generated in the `packages` folder

cmake --build . --target package

```

## Want to contribute a translation ?

Although not currently thoroughly documented, adding a new translation is actually easy and should not take more than a few minutes for a full translation. Please [create a GitHub issue](https://github.com/charlesfleche/lpd8editor/issues/new?title=New+translation+request) and we'll guide you.

## LPD8 sysex

Akai does not provide a MIDI and Sysex implementation sheet, so we [reverse engineered our own](doc/SYSEX.md).