{"id":13478174,"url":"https://github.com/glicol/glicol-cli","last_synced_at":"2025-03-27T07:30:50.550Z","repository":{"id":154190386,"uuid":"611951525","full_name":"glicol/glicol-cli","owner":"glicol","description":"glicol cli: cross-platform music live coding in terminal","archived":false,"fork":false,"pushed_at":"2024-12-09T16:16:51.000Z","size":1703,"stargazers_count":143,"open_issues_count":9,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-12-09T17:29:21.968Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/chaosprint/glicol","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glicol.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-09T22:06:13.000Z","updated_at":"2024-12-09T16:16:55.000Z","dependencies_parsed_at":"2024-05-21T16:45:40.085Z","dependency_job_id":"09c12bf8-777e-4aa3-bbfd-e5925e8a60bb","html_url":"https://github.com/glicol/glicol-cli","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glicol%2Fglicol-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glicol%2Fglicol-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glicol%2Fglicol-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glicol%2Fglicol-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glicol","download_url":"https://codeload.github.com/glicol/glicol-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245802263,"owners_count":20674622,"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":[],"created_at":"2024-07-31T16:01:53.452Z","updated_at":"2025-03-27T07:30:50.197Z","avatar_url":"https://github.com/glicol.png","language":"Rust","funding_links":[],"categories":["Rust","💻 Apps"],"sub_categories":["🎼 Music and Media"],"readme":"# glicol-cli\n\nhttps://user-images.githubusercontent.com/35621141/226138600-199aed46-4f16-4ae2-9951-716181782f59.mp4\n\n## What's this?\n\nIt's a command line interface that you can use for music live coding with [Glicol](https://glicol.org).\n\nIt watches a file changes and then update the music in real-time.\n\n## How to use it?\n\n### Step 1\n\nYou need to have `cargo` installed (see [here](https://doc.rust-lang.org/cargo/getting-started/installation.html)).\n\n### Step 2\n\nIn your Terminal:\n\n```sh\ncargo install --git https://github.com/glicol/glicol-cli.git\n```\n\n### Step 3\n\nCreate a new file called `test.glicol`, then run this command in your Terminal:\n\n```sh\nglicol-cli test.glicol\n```\n\nFor more `OPTIONS`, call `--help` in your terminal:\n\n```\n~ glicol-cli --help\n\nGlicol cli tool. This tool will watch the changes in a .glicol file\n\nUsage: glicol-cli [OPTIONS] \u003cFILE\u003e\n\nArguments:\n  \u003cFILE\u003e  path to the .glicol file\n\nOptions:\n  -b, --bpm \u003cBPM\u003e        Set beats per minute (BPM) [default: 120]\n  -d, --device \u003cDEVICE\u003e  The audio device to use [default: default]\n  -H, --headless         Disable the TUI\n  -h, --help             Print help\n  -V, --version          Print version\n```\n\n### Step 4\n\nStart live coding. Edit `test.glicol` with your favourite editor:\n\n```\n// test.glicol\n~t1: speed 4.0 \u003e\u003e seq 60 \u003e\u003e bd 0.2 \u003e\u003e mul 0.6\n\n~t2: seq 33_33_ _33 33__33 _33\n\u003e\u003e sawsynth 0.01 0.1\n\u003e\u003e mul 0.5 \u003e\u003e lpf 1000.0 1.0\n\nout: mix ~t.. \u003e\u003e plate 0.1\n```\n\n## Load your own samples\n\nRun the line in your terminal first:\n\n`export GLICOL_CLI_SAMPLES_PATH=/path/to/your/samples`\n\nFor example:\n\n`export GLICOL_CLI_SAMPLES_PATH=~/Downloads/samples`\n\n## Development\n\nIf you are developing the glicol-cli source code itself, you can setup\na convenient self-recompiling debug binary alias:\n\n * Install\n[Just](https://github.com/casey/just?tab=readme-ov-file#readme)\n\n```sh\ncargo install just\n```\n\n * Put the alias into your shell init (`~/.bashrc`):\n\n```\n# Point this to the Justfile found in your git clone:\nalias glicol-cli='just -f ~/git/vendor/glicol/glicol-cli/Justfile run'\n```\n\nThis special `glicol-cli` alias can be run from any directory, and the\nprogram will automatically recompile itself before running the\nprogram. You can still provide `glicol-cli` command line arguments as\nnormal.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglicol%2Fglicol-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglicol%2Fglicol-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglicol%2Fglicol-cli/lists"}