-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add link to install script to 'dist' folder
- Loading branch information
1 parent
44716a9
commit 0422eb9
Showing
7 changed files
with
208 additions
and
62 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,27 @@ | ||
| * [e0ce59b] Update documentation | ||
| * [16fccfb] Reorganise documentation | ||
| * [1d97106] Resave set | ||
| * [6d7071f] Add link to install script to 'dist' folder | ||
| * [44716a9] Stream Deck - Replace keyboard icon with download from Font Awesome | ||
| * [11facd1] Stream Deck - Change Select and Save icons in Remix Deck; remove Trigger button | ||
| * [ba166fb] Stream Deck - Add button to generate screenshots of Stream Deck pages | ||
| * [cb91c83] Stream Deck - Add Reverse button; Change Pause button to Stop | ||
| * [fe4683b] Refine folder structure, install presets into appropriate live folders, move legacy presets to control-live repository (fixes #54, fixes #55) | ||
| * [1b013b1] Update Streamdeck mappings in CSV format | ||
| * [d8b10e6] Remove redundant files | ||
| * [d9fac38] Remove redundant files | ||
| * [b904330] Update Streamdeck mappings in CSV format | ||
| * [5757a0b] Fix build error (#50), refine folder structure | ||
| * [0f9caf4] Document version changes; add Streamdeck mappings in CSV format; remove redundant button icons; rename profile pages | ||
| * [2a582df] Document version changes; add Streamdeck mappings in CSV format; remove redundant button icons; rename profile pages | ||
| * [2fe19fa] Remove redundant SHIFTed reset from Dry/Wet button | ||
| * [b26c377] Document version changes; add Streamdeck mappings in CSV format; fix missing M4L preset | ||
| * [54ebdb8] Update library version, update Node and NPM versions, update dependencies | ||
| * [589d7f8] Rename Streamdeck profile and name pages | ||
| * [7577cab] Remove Streamdeck backup files as they contain unrelated profiles | ||
| * [a21e2d0] Copy streamdeck-midi-plugin/cycle-files into Application Support folder (fixes #52) (+1 squashed commit) Squashed commits: [203aedd] Copy streamdeck-midi-plugin/cycle-files into Application Support folder (fixes #52) | ||
| * [4602d40] Version 6 (#49) | ||
| * [50801bb] Add app openers / profile switchers for Traktor and Live | ||
| * [9d7f3d4] MCU - update app targets from Ableton Live 11 to Ableton Live 12; remove links to launch Traktor and Ableton as these are superseded by StreamDeck profiles | ||
| * [b240d20] Add Button Creator icon | ||
| * [0c94794] Add link to Supreme MOD Patreon page | ||
| * [d657f82] BPM/2 and BPMx2 now also disable BPM Lock (Grid Analysis Lock) | ||
| * [0d88117] Sidecar script not working with macOS Sonoma, so change to brightness toggle | ||
| * [5169836] Fix Push2 port |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,104 @@ | ||
| # Control Traktor | ||
|
|
||
| ## System requirements | ||
|
|
||
| * macOS (tested on *Sonoma 14.7.1*) | ||
| * Traktor Pro (tested on *Traktor 3.11*) | ||
| * Terminal (to run installation script) | ||
|
|
||
| ### For S8 controls | ||
|
|
||
| * Traktor Kontrol S8 | ||
|
|
||
| ### For routing S8 inputs to Deck D | ||
|
|
||
| * Rogue Amoeba Loopback (tested on *2.4.5*) | ||
|
|
||
| ### For Stream Deck controls | ||
|
|
||
| * Elgato Stream Deck XL | ||
|
|
||
| ### For pitching of deck key | ||
|
|
||
| * Korg nanoKEY2 | ||
|
|
||
| ### For MIDI sequencing of hot cues & freeze slices | ||
|
|
||
| * Ableton Live (tested on *Live 12*) | ||
| * Push 2 | ||
| * ClyphX Pro (for *Live 12*) | ||
|
|
||
| --- | ||
|
|
||
| ## Installation script | ||
|
|
||
| 1. Download the latest release zip from <https://github.com/dotherightthing/control-traktor/releases> | ||
| 2. Extract the zip folder | ||
| 3. Open Terminal.app | ||
| 4. Type `cd `, drag the extracted zip folder into Terminal, then press ENTER, to set the release folder as the root directory | ||
| 5. Type `chmod a+x install.sh` followed by ENTER, to make the installation script executable | ||
| 6. Type `./install.sh 3.11.1` followed by ENTER, to run the installation script (note: this library has only been tested with Traktor `3.11.1`) | ||
| 7. Open *live/CT6.als* to view the Live set | ||
|
|
||
| The following files will automatically be installed: | ||
|
|
||
| * `Macintosh HD/Users/USERNAME/nativeKONTROL` | ||
| * `ClyphX_Pro` | ||
| * `Macintosh HD/Users/USERNAME/Documents/Native Instruments` | ||
| * `CT6 - App Export.tsi` | ||
| * `CT6 - Deck A.tsi` | ||
| * `CT6 - Deck B.tsi` | ||
| * `CT6 - Global.tsi` | ||
| * `CT6 - Korg nanoKEY2.tsi` | ||
| * `CT6 - S8.tsi` | ||
| * `CT6 - Streamdeck XL.tsi` | ||
| * `Macintosh HD/Users/USERNAME/Library/Application Support/Loopback` | ||
| * `Devices.plist` | ||
| * `RecentApps.plist` | ||
| * `Macintosh HD/Users/USERNAME/Library/Application Support/control-traktor` | ||
| * `live` | ||
| * `CT6.als` | ||
| * `streamdeck-xl/plugins/streamdeck-midi-plugin/cycle-files` | ||
| * various XML files | ||
| * `Macintosh HD/Users/USERNAME/Music/Ableton/User Library/Presets` | ||
| * `Instruments/Drum Rack` | ||
| * `CT6 SeqPads.adg` | ||
| * `Instruments/Instrument Rack` | ||
| * `CT6 Rack.adg` | ||
| * `MIDI Effects/Max MIDI Effect` | ||
| * `CT6 Params.adv` | ||
| * `CT6 Params.amxd` | ||
| * `MIDI Effects/Pitch` | ||
| * `CT6 Liveto Traktor.adv` | ||
|
|
||
| ## Manually install the copied controller mappings | ||
|
|
||
| 1. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - App Export.tsi` | ||
| 2. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - Deck A.tsi` | ||
| 3. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - Deck B.tsi` | ||
| 4. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - Global.tsi` | ||
| 5. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - Korg nanoKEY2.tsi` | ||
| 6. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - S8.tsi` | ||
| 7. Traktor > Settings > Add > Import TSI > Import Other... > `CT6 - Streamdeck XL.tsi` | ||
|
|
||
| ## Ableton Live | ||
|
|
||
| ### Set up Virtual MIDI ports | ||
|
|
||
| These allow the Stream Deck XL and Ableton Live to communicate. | ||
|
|
||
| 1. Open Audio MIDI Setup | ||
| 2. Double-click IAC Driver (in red) | ||
| 3. Click `+` to add a Bus | ||
| 4. Double-click the bus name and rename to `StreamDeck2Daw` | ||
| 5. Click `+` to add a second Bus | ||
| 6. Double-click the second bus name and rename to `Daw2StreamDeck` | ||
| 7. Ensure that *Device is online* is checked | ||
| 8. Click *Apply* | ||
|
|
||
| ### Enable Virtual MIDI ports | ||
|
|
||
| 1. Open Ableton Live | ||
| 2. Open *Settings* > *Link, Tempo & MIDI* | ||
| 3. Under *Input Ports*, locate *IAC Driver (StreamDeck2Daw)* and select the *Track* and *Remote* checkboxes | ||
| 4. Under *Input Ports*, locate *IAC Driver (Daw2StreamDeck)* and select the *Track* and *Remote* checkboxes |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,45 @@ | ||
| #!/bin/bash | ||
|
|
||
| # File: ./scripts/install.sh | ||
| # Description: Copy files from dist folder to system folders | ||
| # | ||
| # Note: | ||
| # chmod a+x = Change access permissions of this file, to 'e[x]ecutable' for '[a]ll users' | ||
| # | ||
| # Example: | ||
| # --- | ||
| # chmod a+x scripts/*.sh | ||
| # --- | ||
|
|
||
| # e: exit the script if any statement returns a non-true return value | ||
| # v: print shell input lines as they are read (including all comments!) | ||
| set -e | ||
|
|
||
| if [ -z "$1" ]; then | ||
| echo "Please call this script with 'install.sh 3.11.1', where 3.11.1 is the Traktor version" | ||
| fi | ||
|
|
||
| # if $GITHUB_ACTIONS does not exist 'then' script is being run locally rather than on CI | ||
| if [ -n "$1" ] && [ -z "$GITHUB_ACTIONS" ] | ||
| then | ||
| rm -rf ~/"Library/Application Support/control-traktor/" || true \ | ||
| && mkdir -p ~/"Library/Application Support/control-traktor/live" \ | ||
| && mkdir -p ~/"Library/Application Support/control-traktor/streamdeck-xl/plugins/streamdeck-midi-plugin/cycle-files" \ | ||
| && echo "Installing ClyphX Pro support files" \ | ||
| && cp "./clyphx-pro/"* ~/"nativeKONTROL/ClyphX_Pro" \ | ||
| && echo "Installing Loopback support files" \ | ||
| && cp "./loopback/"*.plist ~/"Library/Application Support/Loopback" \ | ||
| && echo "Installing Live support files" \ | ||
| && cp "./live/"*.als ~/"Library/Application Support/control-traktor/live" \ | ||
| && cp "./live/Instruments/Drum Rack/CT6 Seq Pads.adg" ~/"Music/Ableton/User Library/Presets/Instruments/Drum Rack" \ | ||
| && cp "./live/Instruments/Instrument Rack/CT6 Rack.adg" ~/"Music/Ableton/User Library/Presets/Instruments/Instrument Rack" \ | ||
| && cp "./live/MIDI Effects/Max MIDI Effect/CT6 Params.adv" ~/"Music/Ableton/User Library/Presets/MIDI Effects/Max MIDI Effect" \ | ||
| && cp "./live/MIDI Effects/Max MIDI Effect/CT6 Params.amxd" ~/"Music/Ableton/User Library/Presets/MIDI Effects/Max MIDI Effect" \ | ||
| && cp "./live/MIDI Effects/Pitch/CT6 Live to Traktor.adv" ~/"Music/Ableton/User Library/Presets/MIDI Effects/Pitch" \ | ||
| && echo "Installing Stream Deck support files" \ | ||
| && cp "./streamdeck-xl/plugins/streamdeck-midi-plugin/cycle-files/"*.xml ~/"Library/Application Support/control-traktor/streamdeck-xl/plugins/streamdeck-midi-plugin/cycle-files" \ | ||
| && echo "Installing Traktor support files" \ | ||
| && cp "./traktor/"* ~/"Documents/Native Instruments/Traktor $1" \ | ||
| && open "./traktor/" \ | ||
| && echo "Automatic install tasks complete." | ||
| fi |