{"id":16220024,"url":"https://github.com/kuba2k2/espionage-bot","last_synced_at":"2025-09-17T11:32:41.376Z","repository":{"id":40432891,"uuid":"345146900","full_name":"kuba2k2/espionage-bot","owner":"kuba2k2","description":"A Discord bot that plays the Nokia Espionage ringtone for any user entering the AFK channel.","archived":false,"fork":false,"pushed_at":"2024-02-18T18:57:53.000Z","size":173,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-10-11T11:56:48.921Z","etag":null,"topics":["bot","discord","discord-bot","docker","espionage"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/kuba2k2/espionage-bot","language":"Python","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/kuba2k2.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-03-06T16:57:27.000Z","updated_at":"2022-05-09T05:34:55.000Z","dependencies_parsed_at":"2024-02-15T16:51:52.135Z","dependency_job_id":null,"html_url":"https://github.com/kuba2k2/espionage-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuba2k2%2Fespionage-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuba2k2%2Fespionage-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuba2k2%2Fespionage-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kuba2k2%2Fespionage-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kuba2k2","download_url":"https://codeload.github.com/kuba2k2/espionage-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221726866,"owners_count":16870711,"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","discord","discord-bot","docker","espionage"],"created_at":"2024-10-10T11:56:54.173Z","updated_at":"2025-09-17T11:32:36.047Z","avatar_url":"https://github.com/kuba2k2.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# espionage-bot\n\nA Discord bot that plays the Nokia Espionage ringtone for any user entering the AFK channel.\n\nThe bot can also be summoned manually using commands in `files.json`.\n\n## Usage\n\n### With Docker Compose\n```bash\n$ mkdir -p ~/docker/espionage-bot\n$ cd ~/docker/espionage-bot\n$ mkdir ./data/\n$ wget https://raw.githubusercontent.com/kuba2k2/espionage-bot/master/docker-compose.yml\n$ vim docker-compose.yml\n```\nEdit the file adding your Discord bot token to `BOT_TOKEN=`.\n\nChoose your desired MIDI implementation in `image:` element:\n```bash\nkuba2k2/espionage-bot:latest-nomidi         # without MIDI support\nkuba2k2/espionage-bot:latest-fluidsynth     # with MIDI playback with FluidSynth\nkuba2k2/espionage-bot:latest-timidity       # with MIDI playback with TiMidity++\n```\n\nPlace the `espionage.mp3` file in `~/docker/espionage-bot/data` (or edit the Compose environment variables accordingly).\n\nRun `espionage-bot`:\n```bash\n$ docker-compose up --detach\n```\n\n### With Docker\n```bash\n$ git clone https://github.com/kuba2k2/espionage-bot\n$ cd espionage-bot\n$ mkdir ./data/\n$ cp .env.example .env\n$ vim .env\n```\nEdit the file adding your Discord bot token to `BOT_TOKEN=`.\n\nPlace the `espionage.mp3` file in the `data/` directory.\n\nPull and run the image:\n```bash\n# without MIDI support\n$ docker run -d -v $(pwd)/data:/app/data --env-file .env kuba2k2/espionage-bot:latest-nomidi\n# with MIDI playback with FluidSynth\n$ docker run -d -v $(pwd)/data:/app/data --env-file .env kuba2k2/espionage-bot:latest-fluidsynth\n# with MIDI playback with TiMidity++\n$ docker run -d -v $(pwd)/data:/app/data --env-file .env kuba2k2/espionage-bot:latest-timidity\n```\n\n### With Python (pipenv)\n```bash\n$ git clone https://github.com/kuba2k2/espionage-bot\n$ cd espionage-bot\n$ mkdir ./data/\n$ cp .env.example .env\n$ vim .env\n```\nEdit the file adding your Discord bot token to `BOT_TOKEN=`.\n\nPlace the `espionage.mp3` file in the `data/` directory.\n\nRefer to the discord-py installation guide for other dependencies, e.g. on Linux:\n```bash\n$ apt install libffi-dev libnacl-dev python3-dev\n$ apt install ffmpeg\n$ apt install libmagic1\n# For MIDI file support - choose one\n# When installing MIDI support configure MIDI_IMPL in .env\n$ apt install fluidsynth\n$ apt install timidity\n```\n\nInstall and run the project:\n```bash\n$ pipenv install\n$ pipenv run python start.py\n```\n\n## Notes\nWhen migrating from previous versions put the old `FILES_JSON` and configured `ESPIONAGE_FILE`\nin `DATA_PATH` to have all audio files moved automatically.\n\nThe bot should at least have the `Connect`, `Speak`, `Mute Members` and `Move Members` permissions.\n\nTo use the MIDI support you should upload at least one SoundFont (.sf2) prior to playing, else weird things may happen.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuba2k2%2Fespionage-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuba2k2%2Fespionage-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuba2k2%2Fespionage-bot/lists"}