{"id":15093399,"url":"https://github.com/mlg404/whatsapp-music-bot","last_synced_at":"2025-04-10T01:15:25.292Z","repository":{"id":37792272,"uuid":"272111506","full_name":"mlg404/whatsapp-music-bot","owner":"mlg404","description":"A whatsapp bot to send and search musics to your friends!","archived":false,"fork":false,"pushed_at":"2024-02-04T21:31:47.000Z","size":11919,"stargazers_count":131,"open_issues_count":5,"forks_count":88,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-10T01:15:16.820Z","etag":null,"topics":["bot","bots","music","music-bot","nodejs","whatsapp","whatsapp-web"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/mlg404.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":"2020-06-14T01:12:10.000Z","updated_at":"2025-02-18T00:13:40.000Z","dependencies_parsed_at":"2024-09-19T20:00:55.057Z","dependency_job_id":"df262d2f-d635-4a2c-9507-232399220fd0","html_url":"https://github.com/mlg404/whatsapp-music-bot","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlg404%2Fwhatsapp-music-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlg404%2Fwhatsapp-music-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlg404%2Fwhatsapp-music-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlg404%2Fwhatsapp-music-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlg404","download_url":"https://codeload.github.com/mlg404/whatsapp-music-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137891,"owners_count":21053775,"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":["bot","bots","music","music-bot","nodejs","whatsapp","whatsapp-web"],"created_at":"2024-09-25T11:22:29.235Z","updated_at":"2025-04-10T01:15:25.269Z","avatar_url":"https://github.com/mlg404.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg alt=\"Whatsapp music bot\" title=\"Whatsapp music bot\" src=\".github/wpp.png\" width=\"200px\" /\u003e\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n  WhatsApp Music Bot v3\n\u003c/h3\u003e\n\u003ch6 align=\"center\"\u003e\u003ci\u003enow for Multidevices!\u003c/i\u003e\u003c/h6\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"GitHub top language\" src=\"https://img.shields.io/github/languages/top/mlg404/whatsapp-music-bot.svg\"\u003e\n\n  \u003cimg alt=\"GitHub language count\" src=\"https://img.shields.io/github/languages/count/mlg404/whatsapp-music-bot.svg\"\u003e\n\n  \u003cimg alt=\"Repository size\" src=\"https://img.shields.io/github/repo-size/mlg404/whatsapp-music-bot.svg\"\u003e\n  \u003ca href=\"https://github.com/mlg404/whatsapp-music-bot/commits/master\"\u003e\n    \u003cimg alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/mlg404/whatsapp-music-bot.svg\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/mlg404/whatsapp-music-bot/issues\"\u003e\n    \u003cimg alt=\"Repository issues\" src=\"https://img.shields.io/github/issues/mlg404/whatsapp-music-bot.svg\"\u003e\n  \u003c/a\u003e\n\n  \u003cimg alt=\"GitHub\" src=\"https://img.shields.io/github/license/mlg404/whatsapp-music-bot.svg\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#rocket-info\"\u003eInfo\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#computer-technologies\"\u003eTechnologies\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#information_source-how-to\"\u003eHow to\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#mag_right-functionalities\"\u003eFunctionalities\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#busts_in_silhouette-contribute\"\u003eContribute\u003c/a\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;|\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003ca href=\"#memo-license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" style=\"display: flex; flex-direction: column; align-items: center; justify-content:center;\"\u003e\n  \u003cimg alt=\"Web Gif\" src=\".github/download.gif\" width=\"600px\"\u003e\n  \u003cimg alt=\"Web Gif\" src=\".github/cached.gif\" width=\"600px\"\u003e\n\u003c/p\u003e\n\n## :rocket: Info\n\nYour whatsapp becomes a music bot!. You can send music's to your friend's private conversation or in your gropus just sending `!play SONG_NAME` where SONG_NAME is the name of the song you are looking for!\n\n\u003cstrong\u003eWARNING:\u003c/strong\u003e this bot is not hosted. You need to host it by yourself\n\n## :computer: Technologies\n\nThis project was developed following this technologies:\n\n- [ytdl](https://www.npmjs.com/package/ytdl-core)\n- [eslint](https://eslint.org/)\n- [ffmpeg](https://ffmpeg.org/)\n- [Prettier](https://prettier.io/)\n- [Node.js](https://nodejs.org/en/)\n- [VS Code][vc]\n- [Typescript](https://www.typescriptlang.org/)\n- [YouTube Search](https://www.npmjs.com/package/yt-search)\n- [QrCode Terminal](https://www.npmjs.com/package/qrcode-terminal)\n- [Whatsapp WEB js](https://pedroslopez.me/whatsapp-web.js/)\n\n## :information_source: How To\n\n\nhttps://user-images.githubusercontent.com/120257933/233465324-bfb1df96-51c4-4a02-acdf-25bdb5078e28.mp4\n\n\nTo clone this application you will need [Git](https://git-scm.com) + [Node.js v16][nodejs] or higher + [Yarn v1.22.4][yarn] or higher installed in your computer. Run in terminal:\n\n```bash\n# Clone this repo\n$ git clone https://github.com/mlg404/whatsapp-music-bot.git whatsapp-music-bot\n\n# Access this repo\n$ cd whatsapp-music-bot\n\n# Install dependencies with yarn\n$ yarn install\n\n# Run the application with yarn (or npm run dev)\n$ yarn start\n```\n\n\u003cbr /\u003e\nSee available langs in `src/language.ts`. Configure your language in `config.ts` file:\n\n```ts\nexport const LANGUAGE = 'br'; // brazilian portuguese\n\n// or\n\nexport const LANGUAGE = 'en'; // english\n```\n\nAfter script run, you need to scan the QrCode in your terminal with your whatsapp! (Same proccess to join whatsapp web)\n\n## :mag_right: Functionalities\n\nSee the current features!\n\n- Search a song directly from youtube;\n- Songs once searched are downloaded for optimized next searches;\n- Send songs in private or in groups;\n- Your friends can send the command too;\n- \u003cs\u003eYou can enable the \"Download progress\";\u003c/s\u003e\n- Prevents downloading videos more than MAX DURATION minutes long.\n- New command's system\n- Help command\n\n## :stars: Upcoming features\n\n- New error handling\n- Redesigned music cache\n\n## :busts_in_silhouette: Contribute\n\n- Fork this repository;\n- Create one branch with your feature: `git checkout -b my-feature`;\n- Commit your alterations: `git commit -m 'feat: My new feature'`;\n- Push to your branch: `git push origin my-feature`.\n\nOpen a pull request with your branch. After pull request merge, you should delete your branch.\n\u003cbr /\u003e\nWe need some translations too! Look for `language.ts` file! **It's so easy!**\n\n## :memo: License\n\nThis project is under MIT license. See [LICENSE](https://github.com/mlg404/whatsapp-music-bot/blob/master/LICENSE) for more information.\n\n---\n\nMade with 💙 by Victor Eyer :wave: [Get in touch!](https://www.linkedin.com/in/victoreyer/)\n\n[nodejs]: https://nodejs.org/\n[yarn]: https://classic.yarnpkg.com/lang/en/\n[vc]: https://code.visualstudio.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlg404%2Fwhatsapp-music-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlg404%2Fwhatsapp-music-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlg404%2Fwhatsapp-music-bot/lists"}