{"id":18292275,"url":"https://github.com/bkataru/overtranslator","last_synced_at":"2026-02-10T09:02:50.458Z","repository":{"id":38962207,"uuid":"133548711","full_name":"bkataru/overtranslator","owner":"bkataru","description":"Repository for the translator-bot made for Discord. Inspired by SkullTech's repeated Google translation python script","archived":false,"fork":false,"pushed_at":"2024-04-18T13:55:47.000Z","size":48,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-11T08:48:58.410Z","etag":null,"topics":["discord","discord-api","discord-bot","discord-py","google-translate","google-translate-api","memes","memes4life"],"latest_commit_sha":null,"homepage":"","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/bkataru.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,"publiccode":null,"codemeta":null}},"created_at":"2018-05-15T17:11:49.000Z","updated_at":"2024-03-20T17:52:35.000Z","dependencies_parsed_at":"2025-02-11T08:58:55.503Z","dependency_job_id":null,"html_url":"https://github.com/bkataru/overtranslator","commit_stats":null,"previous_names":["bkataru/translator-bot","bkataru/overtranslator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fovertranslator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fovertranslator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fovertranslator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bkataru%2Fovertranslator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bkataru","download_url":"https://codeload.github.com/bkataru/overtranslator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247341052,"owners_count":20923368,"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":["discord","discord-api","discord-bot","discord-py","google-translate","google-translate-api","memes","memes4life"],"created_at":"2024-11-05T14:17:36.502Z","updated_at":"2026-02-10T09:02:50.388Z","avatar_url":"https://github.com/bkataru.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# translator-bot\n\u003cimg align=\"left\" src=\"https://i.imgur.com/yo0W0R8.png\"\u003e A discord bot that translates a given text repeatedly using Google Translate. For the keks and memes. Originally a Python script by SkullTech, made into a Python Discord bot by BKModding\n\n# [Invite on Discord!](https://discord.com/api/oauth2/authorize?client_id=445572978772541461\u0026permissions=75776\u0026scope=bot)\n\n## What is this and how is this useful?!\nThis bot uses the **bIG BrAiN** of Google Translate to figure out the hidden meanings behind ordinary english text.\nInspired by the following _meme_-videos.\n\n- [Gucci Gang but it's been Google translated over 500 times](https://youtu.be/HMReGXCtTiM)\n- [Pumped Up Kicks but it's been Google translated](https://youtu.be/ZMR395zmT1k)\n\n## Usage\n\n\u003cimg src=\"https://i.imgur.com/9vbaJTu.png\"\u003e\n\u003cimg src=\"https://i.imgur.com/8Rm86rX.png\"\u003e\n\u003cimg src=\"https://i.imgur.com/99ZJij5.png\"\u003e\n\u003cimg src=\"https://i.imgur.com/75KA3cp.png\"\u003e\n\n```\nTranslate text repeatedly using Google Translate. For the keks and memes. \nOriginally by SkullTech. Made into a Discord bot by BK Modding\n\nUsage: !translate [-h] [-n NUM] [-l LANGS [LANGS ...]] [-t] TEXT\n\nRequired arguments:\nTEXT, Input text. Must be specified with -t if including optional arguments. Can be omitted otherwise.\n\nOptional arguments:\n-h HELP, Show this help message and exit\n-n NUM,  Number of times to go through the languages.\n-l LANGS [LANGS ...], ISO 639-1 codes of the languages to use.\n\nNOTE: All optional arguments must come before the TEXT argument (-t)\n\nThe default values of the optional arguments are\n    * NUM 10\n    * LANGS de ko la ja eo\n    \nNOTE: total number of translations is NUM * LANGS\n\nHere's a short listing of all the ISO 639-1 language codes available:\naf sq am ar hy az eu be bn bs bg ca ceb ny zh-cn zh-tw co hr cs da nl en eo et \ntl fi fr fy gl ka de el gu ht ha haw he hi hmn hu is ig id ga it ja jw kn kk \nkm ko ku ky lo la lv lt lb mk mg ms ml mt mi mr mn my ne no or ps fa pl pt pa \nro ru sm gd sr st sn sd si sk sl so es su sw sv tg ta te th tr \nuk ur ug uz vi cy xh yi yo zu\n\nA more detailed listing which includes the corresponding language names can be found here:\nhttps://gist.github.com/BK-Modding/25e5a787486baaabec434bc6a1a96670\n```\n\nA detailed listing of the language names and codes can also be found via the googletrans module:\n```Python\nimport googletrans\ngoogletrans.LANGCODES\n```\n\n### Examples:\n\nThe simplest use-case is one without any arguments:\n```Discord:\n!translate There's vomit on his sweater already, mom's spaghetti\n\nOutput:\n[*] \"There's vomit on his sweater already, mom's spaghetti\" but translated 50 times!\n\n\nNikel-spaghete water (water spaghetti nickel) is solved.\n```\n\nYou can also specify the text argument `-t` here, although it is unnecessary for such a basic use-case.\n```Discord:\n!translate -t There's vomit on his sweater already, mom's spaghetti\n\nOutput:\n[*] \"There's vomit on his sweater already, mom's spaghetti\" but translated 50 times!\n\n\nNikel-spaghete water (water spaghetti nickel) is solved.\n```\n\nA more involved use-case which uses some or all the available arguments, however, requires you to specify the text argument `-t`:\n```Discord\n!translate -n 50 -t There's vomit on his sweater already, mom's spaghetti\n\nOutput:\n[*] \"There's vomit on his sweater already, mom's spaghetti\" but translated 250 times!\n\n\nSpaghetti and vomit in mom's sweater\n```\n\n```Discord\n!translate -n 10 -l de ko hi -t There's vomit on his sweater already, mom's spaghetti\n\nOutput:\n[*] \"There's vomit on his sweater already, mom's spaghetti\" but translated 30 times!\n\n\nYour sweater is already spaghetti to celebrate your mother.\n```\n\n## Improvements and Changes\n\n- Translation workflow is much faster after: \n   - Changing the argument parsing to take on a priority-based conditional check instead of an equivalent iterative loop-based check.\n   - Fixed the translation function call to be correctly asynchronous.\n- Help text updated to include more information.\n- No need to enclose text in quotations anymore.\n- Bot doesn't break if you include quotations (\",') or hiphens (-) in the text now.\n- Optional arguments must come before the text argument now.\n- Accounted for the Bot's reply being longer than Discord's character limit (2000).\n- Added functionality for a simpler use-case that doesn't require any arguments to be specified.\n\n## Requirements for development \n```\nPython 3\ndiscord.py v1.0+\ngoogletrans \n```\n\n## Running the bot\n1. Create a `config.py` and add a discord bot token via a `TOKEN` variable\n    ```\n    TOKEN = \"*token goes here*\"\n    ```\n2. Start the bot by running `botscript.py`\n    ```\n    python3 botscript.py\n    ```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbkataru%2Fovertranslator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbkataru%2Fovertranslator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbkataru%2Fovertranslator/lists"}