{"id":17167427,"url":"https://github.com/kward/tracks","last_synced_at":"2025-06-19T12:35:28.359Z","repository":{"id":57553290,"uuid":"96465852","full_name":"kward/tracks","owner":"kward","description":"Tool to rename files written by Waves Tracks based on Avid VENUE channel names.","archived":false,"fork":false,"pushed_at":"2018-11-03T15:16:53.000Z","size":7327,"stargazers_count":1,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-24T18:21:44.359Z","etag":null,"topics":["avid","cli","daw","golang","pro-tools","tracks","venue","waves"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kward.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-07-06T19:38:53.000Z","updated_at":"2023-02-16T02:26:25.000Z","dependencies_parsed_at":"2022-09-07T17:50:51.919Z","dependency_job_id":null,"html_url":"https://github.com/kward/tracks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kward/tracks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kward%2Ftracks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kward%2Ftracks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kward%2Ftracks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kward%2Ftracks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kward","download_url":"https://codeload.github.com/kward/tracks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kward%2Ftracks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260752180,"owners_count":23057308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avid","cli","daw","golang","pro-tools","tracks","venue","waves"],"created_at":"2024-10-14T23:08:43.318Z","updated_at":"2025-06-19T12:35:23.348Z","avatar_url":"https://github.com/kward.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tracks\n\nTracks is a tool to rename audio files generated by [Waves Tracks Live][tracks_live] based on channel or output names from an [Avid VENUE™][avid_venue] (version 4.5.x or earlier) patch file.\n\n[avid_venue]: http://avid.force.com/pkb/articles/en_US/Download/VENUE-Standalone-Software-Updates\n[tracks_live]: https://www.waves.com/mixers-racks/tracks-live\n\n## Overview\n\nWaves Tracks is an invaluable tool for doing a multi-track recording during a live event. Unfortunately, once the event is over, getting those files into Pro Tools or another DAW can be a pain for several reasons.\n\n- The file names by default have the format \"Track XX-Y.wav\" (XX=track number, and Y=session number), giving no indication of the original channel name.\n- Tracks are sorted alphabetically by track number then session number, making it difficult to pull out all tracks relating to just a single session.\n- The alphabetic sorting of 32 tracks looks like: 1 10 11 12 … 2 20 21 22 … 3 31 32 4 5. Dragging all the tracks sorted this way into Pro Tools requires manually resorting the tracks by hand.\n\nThis software is designed to solve the above problems.\n\n- Files are renamed according to their original channel names, or the Pro Tools output patch names.\n- Session numbers are placed before track numbers, which groups the sessions together.\n\n## Project detail\n\n[![GoDoc](https://godoc.org/github.com/kward/tracks?status.svg)](https://godoc.org/github.com/kward/tracks)\n[![Travis CI](https://travis-ci.org/kward/tracks.png?branch=master)](https://travis-ci.org/kward/tracks)\n[![GoCover](https://gocover.io/_badge/github.com/kward/tracks?0 \"Code coverage.\")](https://gocover.io/github.com/kward/tracks)\n[![Go Report Card](https://goreportcard.com/badge/github.com/kward/tracks \"Report card.\")](https://goreportcard.com/report/github.com/kward/tracks)\n\nThe software is distributed as source code. To compile the code, the [Go programming language](https://golang.org/) must be installed, and the source code and relative libraries installed. See the [Installation](#installation) section below for the necessary steps.\n\n:bulb: Waves Tracks Live is a heavily striped down version of the open source DAW software [Ardour](https://ardour.org/). If you are are on a budget, and need something that will do more than recording and playback, give Ardour a try.\n\n## Usage\nThe example below will make a new copy of all files in a new location. You will need enough space in your destination location to hold these files.\n\n:bulb: In the examples below, you will frequently see the character `~` used in paths. This character is a Unix shell alias for your home directory. On macOS (or Mac OS X), this is equivalent to your :house: folder, e.g. `/Users/kward`. On Windows 10 or Windows 7, it is very similar, e.g. `\\Users\\kward`.\n\n### Saving sessions with Waves Tracks Live\n\nSave your Tracks Live sessions as you normally would. The following screenshot shows that I have saved my session as `~/Music/Tracks Live/20170916 ICF Ladies Night`.\n\n![Waves Tracks Live saved session](https://github.com/kward/tracks/raw/master/resources/Waves%20Tracks%20Live%20-%20Saved%20session.png)\n\n### Exporting a patch list from VENUE\n\nUse the VENUE Patchlist export function, or the Info export function, to write your channel information to a USB stick.\n\n**Export patch list**\n\n![Avid VENUE - Patchbay - Export patch list](https://github.com/kward/tracks/raw/master/resources/Avid%20VENUE%20-%20Patchbay%20-%20Export%20patch%20list.png)\n\n**Export info**\n\n![Avid VENUE - Options - System - Info](https://github.com/kward/tracks/raw/master/resources/Avid%20VENUE%20-%20Options%20-%20System%20-%20Info.png)\n\nVENUE normally writes the patch file to the root of the USB stick with a filename like `Avid VENUE Patch List Sep 10 2017, 4-51 PM.html`. Feel free to copy, move, or rename that file to a location useful to you.\n\n:bulb: Consider moving the file off the USB drive to the same folder as the final location of the renamed files, and give it the name of the session. E.g. `~/Music/Sessions/20170916 ICF Ladies Night.html`\n\nPerform a test run of renaming all tracks. These steps must be done from the Terminal.\n\n:bulb: If you aren't at your console, you can use the standalone VENUE software (Windows only) to export the channel information as well.\n\n### Copy the session files\n\nIn this example, we will make a copy of all the files into a newly created `~/Music/Sessions/20170916 ICF Ladies Night Stems` folder. Once we are sure the files are copied as we like, the original `~/Music/Tracks Live/20170916 ICF Ladies Night` folder will be removed.\n\n:warning: The examples below assume that the `tracks` binary was compiled according to the [Installation](#installation)\n\n:bulb: Why add the term `Stems` to the end of the new folder? This isn't required, but when a Pro Tools session is created later, the best name for it will likely be `20170916 ICF Ladies Night`. If that folder already exists, Pro Tools will complain, and require a different name to be chosen. Adding `Stems` allows a Pro Tools folder to be created with the session name, while keeping the stems separate. It is definitely an option to create the Pro Tools session *before* doing these steps so that the files can be copied directly into the appropriate Pro Tools session folder.\n\n:warning: If you chose to rename the files in place by not providing a `dest_dir` flag, it is **highly recommended** that you make a backup of your files before running the software.\n\nCreate the new folder. (This could also be done in Finder or Windows Explorer).\n\n```console\n$ mkdir \"~/Music/Sessions/20170916 ICF Ladies Night Stems\"\n```\n\nDo a dry run of copying the files. :memo: No files will be changed because the `--dry_run` flag was given.\n\n```console\n$ tracks \\\n  --dry_run \\\n  move \\\n    --src_dir \"~/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170916 ICF Ladies Night/audiofiles\" \\\n    --dest_dir \"~/Music/Sessions/20170906 ICF Ladies Night Stems\" \\\n    --patch_file \"~/Music/Sessions/20170906 ICF Ladies Night.html\"\n```\n\nCheck the output produced. Below is some sample output (scroll to the right).\n\n```text\nMoving:\n  \"/Users/kward/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170906 ICF Ladies Night/audiofiles/Track 01-1.wav\" --\u003e \"/Users/kward/Music/Sessions/20170906 ICF Ladies Night Stems/01-01 Cajon (direct out).wav\"\n  \"/Users/kward/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170906 ICF Ladies Night/audiofiles/Track 02-1.wav\" --\u003e \"/Users/kward/Music/Sessions/20170906 ICF Ladies Night Stems/01-02 Shaker (direct out).wav\"\n  \"/Users/kward/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170906 ICF Ladies Night/audiofiles/Track 03-1.wav\" --\u003e \"/Users/kward/Music/Sessions/20170906 ICF Ladies Night Stems/01-03 aRuben (direct out).wav\"\n  \"/Users/kward/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170906 ICF Ladies Night/audiofiles/Track 04-1.wav\" --\u003e \"/Users/kward/Music/Sessions/20170906 ICF Ladies Night Stems/01-04 aToby-L (direct out).wav\"\n...\n```\n\nPerform the actual copy by running the command again without the `--dry_run` flag (notice the trailing `\\` character on the `--patch_file` line was also removed).\n\n```console\n$ tracks \\\n  move \\\n    --src_dir \"~/Music/Tracks Live/20170906 ICF Ladies Night/interchange/20170916 ICF Ladies Night/audiofiles\" \\\n    --dest_dir \"~/Music/Sessions/20170906 ICF Ladies Night Stems\" \\\n    --patch_file \"~/Music/Sessions/20170906 ICF Ladies Night.html\"\n```\n\nThe output should be the same as above, but this time the files were actually copied.\n\n### Get info about a file\n\nIf you are curious about what type of file information a `.wav` file has, you can use the `info` command.\n\n```console\n$ tracks info --file \"01-64 Main R -23 LUFS (direct out).wav\"\nsample_rate: 48000 Hz, channels: 1 bits_per_sample: 24 frame_count: 307459072 duration: 1h46m45.397333333s\n```\n\n### Checking a file for silence\n\nThere are times when Tracks has issues talking to the audio device, happening more frequently than desired between Tracks and my Avid S3L-X. Luckily, Tracks doesn't break the recording off (like Pro Tools does, which is why I don't use Pro Tools for recording via AVB), and instead records only silence.\n\nTo test for silence, use the `check` command. The file below unfortunately has several blocks of silence, but now I can quickly document where they are, and don't need to listen to the full 1h46m to find them all.\n\n```console\n$ tracks check --file \"01-64 Main R -23 LUFS (direct out).wav\"\n3m43s - 3m50s\n6m50s - 6m58s\n27m10s - 27m15s\n27m15s - 27m23s\n48m54s - 48m59s\n49m0s - 49m2s\n58m38s - 58m43s\n58m44s - 58m52s\n1h25m50s - 1h25m55s\n1h25m55s - 1h25m57s\n1h41m17s - 1h41m24s\n```\n\n## Getting help\n\nTo see a full list of available flags, request `--help`.\n\n```console\n$ tracks --help\nNAME:\n   tracks - A tool for integrating Waves Tracks and Avid Venue\n\nUSAGE:\n   tracks [global options] command [command options] [arguments...]\n\nCOMMANDS:\n     help, h  Shows a list of commands or help for one command\n\n   venue:\n     copy  copy tracks with new names\n     link  make links with new names, without removing original files\n     move  move or rename tracks\n\n   wave:\n     check  check wave files for known errors\n     info   output info about wave file\n\nGLOBAL OPTIONS:\n   --dry_run, -n  do a dry run\n   --help, -h     show help\n   --version, -v  print the version\n```\n\n## Installation\n_This section covers the installation of Go, required Go libraries, and the Tracks source code._\n\nDownload and install the latest version of Go using instructions from https://golang.org/doc/install. The Tracks tool works on all versions of Go starting at v1.6.\n\nTo test setup a Ubuntu 16.04 Linux machine, these commands were used:\n\n```console\n$ sudo apt-get install golang\n$ mkdir ~/opt/go/{bin,pkg,src}\n$ cat \u003c\u003cEOF \u003e~/.bashrc\n# Golang\nexport GOPATH=\"${HOME}/opt/go\"\nexport GOBIN=\"${GOPATH}/bin\"\nPATH=\"${PATH}:${GOBIN}\"\nEOF\n```\n\nLog out and back in to test that the new environment variables were configured properly.\n\nDownload the Tracks tool source code. This will automatically compile the code, and place a binary in the `$GOBIN` directory.\n\n```console\n$ go get -v -t github.com/kward/tracks\n```\n\nTest the installation.\n\n```console\n$ tracks --help\n```\n\n## Updating\n_This section covers updating an existing installation._\n\nTo update the software, run the following command to download the latest source, and compile a new binary.\n\n```console\n$ go get -v -t -u github.com/kward/tracks\n```\n\n## Tested software and systems\n- macOS (10.12 Sierra, 10.13 High Sierra)\n- Waves Tracks Live 1.3\n- Avid D-Show (3.1.1)\n- Avid Profile (unknown version)\n- Avid S3L-X (4.5.3.3)\n- Avid VENUE Standalone (4.5.3)\n- Avid Pro Tools (12.x)\n\n:warning: This software is neither endorsed nor supported by either Waves or Avid.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkward%2Ftracks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkward%2Ftracks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkward%2Ftracks/lists"}