{"id":23756663,"url":"https://github.com/xasopheno/weresocool","last_synced_at":"2025-04-04T14:03:19.422Z","repository":{"id":32621184,"uuid":"136536363","full_name":"xasopheno/weresocool","owner":"xasopheno","description":"A language for composing microtonal music built in Rust. Make cool sounds. Impress your friends/pets/plants.","archived":false,"fork":false,"pushed_at":"2025-03-26T19:06:05.000Z","size":635052,"stargazers_count":60,"open_issues_count":5,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T13:04:27.099Z","etag":null,"topics":["binaural","composition","friends","microtonal","rust","saxophone","sonification","sound","sound-processing","sound-synthesis","stereo"],"latest_commit_sha":null,"homepage":"https://www.weresocool.org/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xasopheno.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":"2018-06-07T22:07:46.000Z","updated_at":"2025-03-22T23:44:19.000Z","dependencies_parsed_at":"2024-01-06T12:01:41.091Z","dependency_job_id":"e284ca8e-da5c-4ef9-82a8-4810e1cf4221","html_url":"https://github.com/xasopheno/weresocool","commit_stats":{"total_commits":894,"total_committers":11,"mean_commits":81.27272727272727,"dds":0.5883668903803132,"last_synced_commit":"3cded50e801f1b96f098047691186687f9fdf764"},"previous_names":[],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xasopheno%2Fweresocool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xasopheno%2Fweresocool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xasopheno%2Fweresocool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xasopheno%2Fweresocool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xasopheno","download_url":"https://codeload.github.com/xasopheno/weresocool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247184127,"owners_count":20897719,"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":["binaural","composition","friends","microtonal","rust","saxophone","sonification","sound","sound-processing","sound-synthesis","stereo"],"created_at":"2024-12-31T19:18:13.527Z","updated_at":"2025-04-04T14:03:19.401Z","avatar_url":"https://github.com/xasopheno.png","language":"Rust","readme":"# **WereSoCool**\n![Cool Tests](https://github.com/xasopheno/WereSoCool/workflows/Cool%20Tests/badge.svg)\n\nA language for composing mictoronal music built in Rust. You might find this language useful if you want to make cool sounds and impress your friends/pets/plants. \n\nThis language is designed to be easy to use, and you don't need any prior knowledge of microtonal music or computer programming. However, experience in either area will certainly be helpful.\n\nThe **WereSoCool CLI** is availble on **macOS**, **Linux** and **Windows**.  You can also explore the language in a Firefox or Chrome browser on a desktop computer in the [WereSoCool Playground](https://www.weresocool.org/playground). Live coding in the browser currently only works on desktop in a Firefox or Chrome browser. \n\n## Documentation:\nIf you want to learn how to make cool sounds using WereSoCool, you'll find cool documentation in English, Portuguêse, and Español\n  at [weresocool.org](https://www.weresocool.org/).\n\n\nI recommend following the tutorials in order and writing your own composition after completing each one. Additional documentation is currently being worked on, as well as a record featuring a great band, so stay tuned. \n\nOn mobile, you can still view the tutorials, but you won't be able to hear anything.\n\n## Installation:\n\n### Macos:\n\n`brew tap xasopheno/weresocool \u0026\u0026 brew install weresocool`\n\n### Arch Linux:\n\nAvailable on the AUR [here](https://aur.archlinux.org/packages/weresocool).\n\n### Cargo:\n\nWereSoCool can be installed on macos, linux, and windows via cargo. You'll also need to install the \"Necessary Dependencies\".\n\n Install cargo by installing [Rustup](https://www.rust-lang.org/en-US/install.html).\n\n`cargo install weresocool`\n\n#### Necessary Dependencies\nMacos:\n`brew install lame libvorbis`\n\nArch Linux (ALSA):\n`sudo pacman -S lame vorbis-tools`\n\nUbuntu (ALSA):\n`sudo apt-get install lame vorbis-tools`\n\nRaspberry Pi OS:\n`sudo apt-get install libmp3lame-dev libasound2-dev`\n\n### Windows\n\nThis software runs on Windows, but in a slightly limited capacity. On Windows, this software is compiled without mp3 and oggvorbis support. I mostly work on macos and linux machines, so I feel a bit out of my depths in Windows land. If you'd like to help work on the Windows implementation, please reach out. \n\nYou can install WereSoCool from source or via cargo. \n\n### From Source:\nYou'll need Cargo and Just.\n\nRust: Cargo is the rust package manager for Rust. Install cargo by installing [Rustup](https://www.rust-lang.org/en-US/install.html).\n\nYou can install from this source code by cloning this repo and then running:\n\nYou'll also need to install [Just](https://github.com/casey/just) - a cool cross-platform command runner. \n\nYou can install from this source code by cloning this repo and then running:\n\n`just install`\n\n\n### WereSoCool CLI\n\n```\nUsage: weresocool [COMMAND]\n\nCommands:\n  new    Create a new .socool file from the template\n  play   Render a .socool file.\n    --watch                    On file save, the composition will be re-rendered\n  demo   Hear a cool sound\n  print  Print a .socool composition to a file\n    --output_dir \u003coutput_dir\u003e\n    --wav                      print a wav file (default)\n    --mp3                      print an mp3\n    --oggvorbis                print an oggvorbis file\n    --csv                      print a csv file\n    --json                     print a json file\n    --stems                    print stems as a zip file\n    --sound                    print all sound file types\n    --all                      print all file types\n  help   Help of the given subcommand(s)\n```\n\n## Development:\n\n### Setup\nRust: Rust is a great language. Install it with [Rustup](https://www.rust-lang.org/en-US/install.html).\n\nJust: Commands are issued via [Just](https://github.com/casey/just).\n\nYou'll need also need to install the following packages:\n\n#### Macos:\n`brew install lame libvorbis`\n\n##### Arch Linux:\n`sudo pacman -S lame vorbis-tools`\n\n##### Ubuntu:\n`sudo apt-get install lame vorbis-tools`\n\n##### Raspberry Pi OS:\n`sudo apt-get install libmp3lame-dev libasound2-dev`\n\n### Build\n`just build`\n\n## Run Tests:\n`just test`\n\n## Special Thanks:\nThis wouldn't exist in a million years if it wasn't for Antonis Stampoulis' help with language design or the help of friends/programmers like Sönke Hahn, Hao Lian, Catharine M, Matt Handler, Alex David, Lee Pender, Amanda Doucette, Khaled Alquaddoomi, Alex Kestner, everyone else that has sat down to program with me.\n\nOf course, special thanks to Maria for always listening to my new_weird_sounds\nand programming problems. - Danny\n\nCopyright (C) 2023 - Danny Meyer\n\nThis program is free software, licensed under the GPLv3 (see LICENSE).\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxasopheno%2Fweresocool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxasopheno%2Fweresocool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxasopheno%2Fweresocool/lists"}