{"id":18746842,"url":"https://github.com/homeworkprod/scanner-soundboard","last_synced_at":"2025-04-12T22:20:36.307Z","repository":{"id":57666323,"uuid":"415145691","full_name":"homeworkprod/scanner-soundboard","owner":"homeworkprod","description":"Trigger sounds via RFID tags or barcodes","archived":false,"fork":false,"pushed_at":"2022-05-15T23:50:06.000Z","size":30,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-13T01:01:36.568Z","etag":null,"topics":["barcode","rfid","rust","soundboard"],"latest_commit_sha":null,"homepage":"https://homework.nwsnet.de/releases/9b23/#scanner-soundboard","language":"Rust","has_issues":false,"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/homeworkprod.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2021-10-08T22:48:48.000Z","updated_at":"2024-04-03T14:53:07.000Z","dependencies_parsed_at":"2022-09-26T20:31:44.699Z","dependency_job_id":null,"html_url":"https://github.com/homeworkprod/scanner-soundboard","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fscanner-soundboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fscanner-soundboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fscanner-soundboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/homeworkprod%2Fscanner-soundboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/homeworkprod","download_url":"https://codeload.github.com/homeworkprod/scanner-soundboard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223548350,"owners_count":17163492,"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":["barcode","rfid","rust","soundboard"],"created_at":"2024-11-07T16:27:11.521Z","updated_at":"2024-11-07T16:27:11.972Z","avatar_url":"https://github.com/homeworkprod.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Scanner Soundboard\n\nReads codes via RFID or 1D/2D barcode USB scanners and plays soundfiles\nmapped to them.\n\nThe input device is grabbed exlusively so that scanned codes will be\npassed to the program regardless of what program/window currently has\nfocus.\n\nI originally developed this to play insider jokes as custom sounds\n(generated via text-to-speech engines) during regular internal evenings\nof [Among Us](https://www.innersloth.com/games/among-us/) games. The\nsounds are triggered by placing 3D-printed Among Us figurines (glued to\ncoin-size RFID tags) on a cheap (~12 €) USB RFID reader, itself covered\nby a 3D-printed plan of a map from the game.\n\n\n## Usage\n\n1. Have a bunch of sound files.\n\n2. Have a bunch of codes to trigger the sounds. Those codes can come\n   from RFID tags (10-digit strings seem to be common) or whatever you\n   can fit in a 1D barcode or matrix/2D barcode (Aztec Code, Data\n   Matrix, QR code, etc.). Anything your scanner supports.\n\n3. Specify the path of the sound files and map the codes to sound\n   filenames in a configuration file (see `config-example.toml` for an\n   example).\n\n4. Find out where your scanner is available as a device. `sudo lsinput`\n   and `sudo dmesg | tail` can help you here. Note that the path can\n   change over time, depending on the order devices are connected.\n\n5. Run the program, pointing to the configuration file and input device:\n\n   ```sh\n   $ scanner-soundboard -c config.toml -i /dev/input/event23\n   ```\n\n\n## Sound Formats\n\nOgg Vorbis and MP3 are supported out of the box. However, the employed\naudio playback library ([rodio](https://github.com/RustAudio/rodio))\nalso supports FLAC, WAV, MP4 and AAC, but those have to be enabled as\nfeatures in `Cargo.toml` and require recompilation of the program.\n\n\n## License\n\nScanner Soundboard is licensed under the MIT license.\n\n\n## Author\n\nScanner Soundboard was created by Jochen Kupperschmidt.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomeworkprod%2Fscanner-soundboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhomeworkprod%2Fscanner-soundboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhomeworkprod%2Fscanner-soundboard/lists"}