{"id":24221548,"url":"https://github.com/michdo93/python-bored-api","last_synced_at":"2025-07-29T18:05:57.271Z","repository":{"id":225336391,"uuid":"765698278","full_name":"Michdo93/python-bored-api","owner":"Michdo93","description":"A Python script accessing the Bored API with translations.","archived":false,"fork":false,"pushed_at":"2024-03-01T13:12:01.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-14T06:19:43.753Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Michdo93.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":"2024-03-01T12:48:43.000Z","updated_at":"2024-03-01T13:12:05.000Z","dependencies_parsed_at":"2024-03-01T14:41:42.366Z","dependency_job_id":null,"html_url":"https://github.com/Michdo93/python-bored-api","commit_stats":null,"previous_names":["michdo93/python-bored-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Michdo93%2Fpython-bored-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Michdo93%2Fpython-bored-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Michdo93%2Fpython-bored-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Michdo93%2Fpython-bored-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Michdo93","download_url":"https://codeload.github.com/Michdo93/python-bored-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241763748,"owners_count":20016162,"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":[],"created_at":"2025-01-14T06:19:13.248Z","updated_at":"2025-03-04T00:45:31.692Z","avatar_url":"https://github.com/Michdo93.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# python-bored-api\nA Python script accessing the Bored API with translations.\n\nYou can use the Azure AI Translator from Microsoft, Translate from MyMemory or LibreTranslate to translate in any language. But you may have to register with one of these providers in order to use the translation. MyMemory is used by default and is the free version. Better results can be achieved by registering.\n\nBored API otherwise only returns English results by default.\n\nThe programme code even contains fixed translations for the categories in German, English, French and Spanish. This is not translated by the Translator because it would otherwise take longer for the result to be returned. Nothing changes in the categories and each translation could otherwise lead to different results.\n\nFurther Informations to the `translate` Module you can finde [here](https://translate-python.readthedocs.io/en/latest/index.html) and about the Bored API you can find [here](http://www.boredapi.com/).\n\n## Pre-Installation\n\nYou have to install via pip:\n\n```\npip install asyncio\npip install bored-api\npip install translate\n```\n\n## Usage\n\nYou have to run:\n\n```\npython bored.py\n```\n\nAs example you will receive:\n\n```\nBUSYWORK: Create or update your resume\nEDUCATION: Research a topic you're interested in\nRECREATIONAL: Go to the gym\nSOCIAL: Catch up with a friend over a lunch date\nDIY: Find a DIY to do\nCHARITY: Contribute code or a monetary donation to an open-source software project\nCOOKING: Create a meal plan for the coming week\nRELAXATION: Take a bubble bath\nMUSIC: Learn to play a new instrument\n\nBeschäftigung: Sichern wichtiger Computerdateien\nBildung: Lernen Sie Express.js\nFreizeit: Yoga machen\nSoziales: Machen Sie eine Fotosession mit ein paar Freunden\nDIY: Lernen Sie Holzbearbeitung\nWohltätigkeit: Leiste Freiwilligenarbeit in deiner lokalen Speisekammer\nKochen: Erstelle ein Kochbuch mit deinen Lieblingsrezepten\nEntspannung: Sitzen Sie im Dunkeln und hören Sie Ihre Lieblingsmusik ohne Ablenkungen\nMusik: Schreibe ein Lied!\n```\n\nWhat you need to bear in mind: Every request to Bored API returns different results. You can see that the results for English and German have been completely regenerated here. Since the `translate` module is already installed, if you want to have the same result translated in several languages, you could rewrite the programme and perform several translations in the main method. For me, this is not desirable as I want to generate random results each time.\n\n## Customization:\n\n```\n# English without \"translate\" the categories\nasyncio.run(main())\n\n## Translations with category translation\n# English to English translation\nasyncio.run(main(\"en\"))\n\n# English to German translation\nasyncio.run(main(\"de\"))\n\n# English to French translation\nasyncio.run(main(\"fr\"))\n\n# English to Spanish translation\nasyncio.run(main(\"es\"))\n\n## Translations without category translation\n# As example English to Czech translation\nasyncio.run(main(\"cz\"))\n\n## Translations with provider\n# Azure AI translator using a secret_access_key (oAuth Access Token)\nasyncio.run(main(\"de\", \"microsoft\", \"********\"))\n\n# translate MyMemory using a valid email address\nasyncio.run(main(\"de\", \"mymemory\", \"********\"))\n\n# LibreTranslate using a secret_access_key (oAuth Access Token)\nasyncio.run(main(\"de\", \"libretranslate\", \"********\"))\n```\n\nFurther informations [here](https://translate-python.readthedocs.io/en/latest/providers.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichdo93%2Fpython-bored-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichdo93%2Fpython-bored-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichdo93%2Fpython-bored-api/lists"}