{"id":19557353,"url":"https://github.com/andrefs/node-sb-builder","last_synced_at":"2025-04-26T22:33:25.972Z","repository":{"id":32011746,"uuid":"35582826","full_name":"andrefs/node-sb-builder","owner":"andrefs","description":"A Node.js CLI to build soundboard websites from Youtube videos","archived":false,"fork":false,"pushed_at":"2018-06-22T09:10:16.000Z","size":7728,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-24T00:07:53.485Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrefs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-14T01:06:25.000Z","updated_at":"2021-04-11T15:29:18.000Z","dependencies_parsed_at":"2022-09-02T20:40:27.488Z","dependency_job_id":null,"html_url":"https://github.com/andrefs/node-sb-builder","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefs%2Fnode-sb-builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefs%2Fnode-sb-builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefs%2Fnode-sb-builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefs%2Fnode-sb-builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrefs","download_url":"https://codeload.github.com/andrefs/node-sb-builder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251063667,"owners_count":21530837,"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-11-11T04:41:55.462Z","updated_at":"2025-04-26T22:33:20.964Z","avatar_url":"https://github.com/andrefs.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sb-builder: A CLI to build soundboard websites from Youtube videos\n\n`sb-builder` is a node.js CLI application which helps building soundboards -- HTML pages with buttons which play sounds when clicked.\n\nIt will help you:\n\n* downloading soundtracks from Youtube videos,\n* extracting sound snippets,\n* generating a soundboard webpage (HTML, static assets, etc)\n\n\n## Install\n\n    npm install -g sb-builder\n\n### Dependencies\n\n* libav-tools (Ubuntu or Debian-based distros)\n\n## Initialize a soundboard project\n\n    sb-builder init \u003cNAME\u003e\n\n    NAME: the name of the soundboard\n\n\n`sb-builder` will create some folders:\n\n* `./sources/` (where the original videos soundtracks will be kept),\n* `./sounds/` (for the edited sound snippets) and\n* `./tmp/` (a folder for temporary files).\n\nAdditionally, a `manifest.json` file will be created to store all the information about the soundboard, its sources and sound snippets.\n\nThis manifest will be updated each time you download a new soundtrack or create a new snippet, and will be later used to generate the soundboard HTML page.\n\n## Add (download) a new source\n\n    sb-builder download \u003cURL\u003e\n\n    URL: the URL of a Youtube video\n\n`sb-builder` will get the video metadata, and download its soundtrack.\n\n## Create a sound snippet\n\n    sb-builder snip \u003cID\u003e\n    sb-builder snip \u003cURL\u003e\n\n`sb-builder` will open an external sound editing tool to allow you to trim the sound.\n\n    ID: The Youtube ID of the source video soundtrack\n    URL: The URL of the Youtube video, including the `t` parameter:\n        https://www.youtube.com/watch?v=O_HyZ5aW76c\u0026t=120s\n\n    Options:\n\n        -f SS, --from SS        Time location of the start of the snippet (in seconds)\n        -d SS, --duration SS    Duration in seconds of the snippet\n        -e TEXT                 Transcription or description of the snippet (if you don't provide it, one will be asked later)\n\n## Fix a sound snippet\n\n    sb-builder snip \u003cSOUND_ID\u003e\n\n`sb-builder` will re-extract sound snippet SOUND\\_ID, and run the whole `snip` process again\n\n    ID: The ID of sound snippet you wish to fix\n\n\n## Generate a soundboard HTML page\n\n    sb-builder render \u003cFOLDER\u003e\n\n    FOLDER: the folder where to create the HTML page\n\n`sb-builder` will create the FOLDER, copy all the sounds and other assets into it, and use the manifest file to render an index.html file for the soundboard.\n\n    Options:\n\n        -h FILE, --header FILE      Location of an header image file to be used in the soundboard index.html\n        -v FOLDER, --views-folder   FOLDER  Render project using custom views\n        -a FOLDER, --assets-folder  FOLDER  Render project using custom assets\n\n##\n\n## Bugs and stuff\n\nOpen a GitHub issue or, preferably, send me a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrefs%2Fnode-sb-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrefs%2Fnode-sb-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrefs%2Fnode-sb-builder/lists"}