{"id":15145795,"url":"https://github.com/pilgrimeru/pilzic","last_synced_at":"2025-07-07T16:39:52.315Z","repository":{"id":199779064,"uuid":"687187895","full_name":"Pilgrimeru/Pilzic","owner":"Pilgrimeru","description":"Pilzic is a feature-rich Discord bot that allows you to play music from various sources, manage your music queue, and enjoy a seamless music experience in your Discord server.","archived":false,"fork":false,"pushed_at":"2024-09-16T17:29:45.000Z","size":259,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-26T11:42:42.839Z","etag":null,"topics":["deezer","discord-bot","discord-music-bot","music-bot","soundcloud","spotify","youtube"],"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/Pilgrimeru.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-09-04T20:30:31.000Z","updated_at":"2024-09-16T17:29:49.000Z","dependencies_parsed_at":"2023-11-19T12:22:09.403Z","dependency_job_id":"be4490d7-bba3-4833-b78e-7c3ea5b391d0","html_url":"https://github.com/Pilgrimeru/Pilzic","commit_stats":null,"previous_names":["pilgrimeru/pilzic"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pilgrimeru%2FPilzic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pilgrimeru%2FPilzic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pilgrimeru%2FPilzic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pilgrimeru%2FPilzic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pilgrimeru","download_url":"https://codeload.github.com/Pilgrimeru/Pilzic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219874595,"owners_count":16554599,"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":["deezer","discord-bot","discord-music-bot","music-bot","soundcloud","spotify","youtube"],"created_at":"2024-09-26T11:42:56.589Z","updated_at":"2024-09-26T11:42:58.218Z","avatar_url":"https://github.com/Pilgrimeru.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pilzic 🎵\n\n![banner](https://i.imgur.com/y73VY4q.jpg)\n\n**Pilzic** is a feature-rich Discord bot that allows you to play music from various sources, manage your music queue, and enjoy a seamless music experience in your Discord server. Whether you want to listen to tracks from YouTube, Spotify, Soundcloud, Deezer, or direct link, this bot has you covered.\n\n## Features 🚀\n\n- 🎵 **Multi-Media Control Buttons:** Easily control your music with interactive buttons.\n- 🌐 **Multi-Language Support:** The bot supports both English and French.\n- 🎶 **Source Variety:** Play music from YouTube, Spotify, Soundcloud, Deezer, and direct links.\n- 📎 **Attachment Playback:** Enjoy the convenience of playing audio attachments.\n- ⏱️ **Automatic Disconnect:** The bot will automatically disconnect if left alone in a voice channel.\n- 🗨️ **Slash Commands and Prefix Commands:** Use either slash commands or traditional prefix commands for ease of use.\n- 🧹 **Auto Message Cleanup:** Automatically remove bot messages for a cleaner chat experience.\n- 💪 **Strongly Typed Code:** The bot is coded in TypeScript for robust and error-free operation.\n- ⚡ **Asynchronous Operations:** Utilizes asynchronous operations extensively for accelerated bot responsiveness.\n- 🤖 **Powered by discord.js and play-dl:** Utilizes popular modules to provide reliable functionality.\n\n## Prerequisites 📋\n\nBefore running the bot, make sure you have the following:\n\n- **Node.js:** Version 16.11.0 or higher.\n- **Discord API Token:** Optionally, enable \"Message Content Intent\" in Discord Developer Portal.\n\n## Installation 🛠️\n\nTo get started with the bot, follow these steps:\n\n1. Clone this repository to your local machine.\n2. Navigate to the bot's directory and run the following command to install dependencies:\n\n   ```bash\n   npm install\n   ```\n\n3. Rename config.env.example to config.env and fill out the values:\n    ```env\n    TOKEN = \"\" # your discord token\n    MAX_PLAYLIST_SIZE = 500 # Maximum number of music fetches per playlist\n    PREFIX = \"!\" # Command prefix\n    AUTO_DELETE = true # Set to true to automatically delete bot responses\n    LOCALE = \"en\" # Language setting, it must exist in the local folder\n    STAY_TIME = 30 # Duration before disconnection when the bot is alone\n    AUDIO_QUALITY = 0 # 0 = minimum, 2 = maximum\n    DEFAULT_VOLUME = 100 # Default volume setting [0;100]\n    MAIN_COLOR = \"#69ADC7\" # Main color for the bot\n    ```\n4. Start the bot with:\n\n   ```bash\n   npm start\n   ```\n\n## Command List 📜\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand the command list\u003c/summary\u003e\n\n- `-autoplay`: Enable automatic queue filling.\n- `-help (h)`: Display all available commands and their descriptions.\n- `-insert`: Add a song to the beginning of the queue.\n- `-invite`: Send the bot's invitation link.\n- `-jumpto (jump)`: Jump to the selected position in the queue.\n- `-loop (l)`: Loop the currently playing music.\n- `-lyrics (ly)`: Get the lyrics of the currently playing song.\n- `-move (l)`: Move the music to loop.\n- `-nowplaying (np)`: Display the currently playing song.\n- `-pause`: Pause the currently playing music.\n- `-ping`: Show the bot's ping.\n- `-play (p)`: Listen to music from YouTube and other sources.\n- `-previous`: Go back in the playback queue.\n- `-queue (q)`: Display the playback queue and the currently playing song.\n- `-remove (rm)`: Remove a song from the queue.\n- `-resume (r)`: Resume playback of the paused music.\n- `-search (sh)`: Search and select videos to listen to.\n- `-seek`: Jump to a specific point in the currently playing music.\n- `-shuffle`: Shuffle the queue.\n- `-skip (s)`: Skip the currently playing song.\n- `-stop`: Stop the music playback.\n- `-uptime (up)`: Check the bot's uptime.\n- `-volume (v)`: Adjust the volume of the currently playing music.\n\n\u003c/details\u003e\n\n## Screenshot 📸\n\n![buttons](https://i.imgur.com/B1WKjlO.png)\n\n## License 📄\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**Enjoy your music experience with Pilzic! 🎶**\n\nIf you have any questions, issues, or suggestions, please feel free to open an [issue](https://github.com/Pilgrimeru/Pilzic/issues) on this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilgrimeru%2Fpilzic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpilgrimeru%2Fpilzic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpilgrimeru%2Fpilzic/lists"}