{"id":20199013,"url":"https://github.com/simongoricar/jingler","last_synced_at":"2026-05-08T20:31:47.882Z","repository":{"id":101730003,"uuid":"377739075","full_name":"simongoricar/jingler","owner":"simongoricar","description":"A Discord bot for spicing up your voice channel entry with random jingles, member theme songs and more.","archived":false,"fork":false,"pushed_at":"2021-06-19T17:14:37.000Z","size":127,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-03T08:31:08.439Z","etag":null,"topics":["bot","discord","discord-bot","jingle","music","python3","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"Python","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/simongoricar.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,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-06-17T07:13:40.000Z","updated_at":"2021-06-19T17:14:30.000Z","dependencies_parsed_at":"2024-01-14T10:19:10.742Z","dependency_job_id":"25914f77-56c6-4365-865c-428c0df235bf","html_url":"https://github.com/simongoricar/jingler","commit_stats":null,"previous_names":["simongoricar/jingler"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/simongoricar/jingler","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simongoricar%2Fjingler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simongoricar%2Fjingler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simongoricar%2Fjingler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simongoricar%2Fjingler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simongoricar","download_url":"https://codeload.github.com/simongoricar/jingler/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simongoricar%2Fjingler/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32795867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","discord","discord-bot","jingle","music","python3","self-hosted"],"created_at":"2024-11-14T04:35:28.628Z","updated_at":"2026-05-08T20:31:47.860Z","avatar_url":"https://github.com/simongoricar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jingler\n![Python 3.8+](https://img.shields.io/badge/python-3.8%2B-blue?style=flat-square)\n![Version](https://img.shields.io/badge/jingler-1.0.2-orange?style=flat-square)\n\nA Discord bot for spicing up your voice channel entry with random jingles, \ncustom member \"theme songs\" and more.\n\n## 1. About\nJingler is a Discord bot for playing short audio clips (also called [jingles](https://www.merriam-webster.com/dictionary/jingle)) in voice channels.\n\nJingler maintains a global list of available jingles. Each user can search them and upload their own short jingles, which will in turn also become available\nto every other user. By default, Jingler will play a random jingle each time a member joins a voice channel.\n\nTo spice things up, each user can set their own favourite jingle - a \"theme song\" of sorts. If a user has a theme song, it will be played each time they\nenter a voice channel. Theme songs override the jingle mode on each server unless their theme song mode is set to `disable` (see below for server configuration).\n\nYou can control jingle behaviour per-server:\n- Jingle mode: you can disable all automatic jingles (`disabled` mode; manually playing them with `.playrandom` is still possible), \n set a specific jingle for your server (`single` mode) or configure Jingler to always play a random, fresh jingle (`random` mode; best option 😉 ).\n- Theme song mode: theme songs are user-specific and (by default) override the server jingle mode if a user has one. If you wish to ignore personal theme songs instead and want to\n force the jingle mode you set for your server, set the theme song mode to `disabled`.\n\n## 2. Commands\n\n### Jingles\n| Command | Usage | Description |\n|----------------|-------|-------------------------------------------------------------------------------------------------------------------------------|\n| .playrandom | / | Manually play a random jingle in your current voice channel. |\n| .listjingles | / | Interactively browse all available jingles. React with appropriate arrows below the message to browse different pages. |\n| .addjingle | / | Interactively add a new jingle. Give it a title and upload the .mp3 file. Note: MP3 files are limited to 1 MB and 10 seconds. |\n| .reloadjingles | / | Reload available jingles. This is generally unnecessary. |\n\n### Server settings\n| Command | Usage | Description |\n|-------------------|----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| .getdefault | / | Displays the default jingle for this server. |\n| .setdefault | (jingle code) | Sets the default jingle for this server. If the server jingle mode isn't set to `single`, this will have no effect. If you know the jingle code already, you can pass it immediately. If not, you'll have a chance to pick one interactively. |\n| .getjinglemode | / | Displays the jingle mode for the current server. |\n| .setjinglemode | [disabled/single/random] | Sets the jingle mode for the current server. Available modes dictate behaviour upon members joining a voice channel:\u003cbr\u003e\u003cbr\u003e **disabled** - do not play any jingles\u003cbr\u003e **single** - play a specific jingle\u003cbr\u003e **random** - play a completely random jingle each time\u003cbr\u003eNote that personal theme songs override this setting, unless the theme song mode is set to `disabled`. |\n| .getthemesongmode | / | Check your current theme song mode in the server. |\n| .setthemesongmode | [enable/disable] | Enable (play if a member has one) or disable (ignore) personal theme songs for this server. |\n\n### User settings\n\n| Command | Usage | Description |\n|:-------------:|:-------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|\n| .getthemesong | / | Check what your current theme song is, if you have one. |\n| .setthemesong | (jingle code/none) | Set your personal theme song. \u003cbr\u003eRun command with \"none\" to remove your theme song. If you know your new theme song (jingle)'s code already, you can add that to the end of the command. If you're not sure yet and want to browse, run the command without additional arguments and you'll have a chance to pick your favourite new jingle interactively. |\n\n### Misc\n| Command | Usage | Description |\n|---------|----------------|--------------------------------------------------------------------------------------------------------------------|\n| .ping | | Shows some basic information about Jingler. |\n| .help | (command name) | Show a list of available commands. If used with a command name, shows information about the command and its usage. |\n\n\n# 3. Installation\nCurrently, I don't run Jingler as a public bot that you could just add to your server.\nHowever, that does not mean that you can't run your own!\nGrab a person familiar with setting up Python and/or Discord bots and let's go!\n\n- First make sure you have [Python 3.8+](https://www.python.org/) installed. Then, follow the instructions on [installing Poetry](https://python-poetry.org/docs/#installation), a Python package manager.\n- When both Python and Poetry are installed, [clone](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository-from-github/cloning-a-repository) or download the Jingler repository\nand store or extract it into a directory of your choosing.\n- Install dependencies by running `poetry install`.\n- Copy `data/configuration.EXAMPLE.toml` to `data/configuration.toml` and fill out the bot token and server whitelist.\n- Start the bot by running `poetry run python jingle_bot.py` or by using `run.sh` (needs `screen` installed) or `run.ps1`.\n- And that's it! Enjoy!\n\nIf you encounter bugs or have feature ideas (that I may or may not implement), feel free open an [`Issue`](https://github.com/DefaultSimon/jingler/issues).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimongoricar%2Fjingler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimongoricar%2Fjingler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimongoricar%2Fjingler/lists"}