{"id":20225999,"url":"https://github.com/cedarctic/chimera","last_synced_at":"2025-04-10T17:05:52.064Z","repository":{"id":31353141,"uuid":"127626858","full_name":"CedArctic/Chimera","owner":"CedArctic","description":"System Remote Control Discord Bot written in Python discord.py","archived":false,"fork":false,"pushed_at":"2023-05-23T00:40:55.000Z","size":181,"stargazers_count":84,"open_issues_count":14,"forks_count":26,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-24T14:46:22.026Z","etag":null,"topics":["bot","computer","control","discord","hacktoberfest","python","remote","video-tutorial"],"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/CedArctic.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}},"created_at":"2018-04-01T12:22:49.000Z","updated_at":"2025-02-27T07:39:03.000Z","dependencies_parsed_at":"2023-01-14T18:51:48.746Z","dependency_job_id":null,"html_url":"https://github.com/CedArctic/Chimera","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedArctic%2FChimera","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedArctic%2FChimera/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedArctic%2FChimera/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CedArctic%2FChimera/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CedArctic","download_url":"https://codeload.github.com/CedArctic/Chimera/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248260322,"owners_count":21074208,"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","computer","control","discord","hacktoberfest","python","remote","video-tutorial"],"created_at":"2024-11-14T07:15:43.379Z","updated_at":"2025-04-10T17:05:52.048Z","avatar_url":"https://github.com/CedArctic.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg  width=\"120\" height=\"120\" src=\"https://user-images.githubusercontent.com/11155359/46568982-b4a6c980-c956-11e8-9232-64b64be1369c.png\"\u003e\n\u003c/p\u003e\n\n\n\n# Chimera\nChimera (not the mythical beast), is a cross platform System Remote Control Discord Bot written in Python discord.py.\nUsing Chimera you can easily control your computer remotely and have it do from simple tasks such as shutdown, sleep and lock to talking or executing powershell commands.\nChimera is a self hosted bot, which means that you have to run the bot on your computer - the machine you want to control via discord commands.\nInstalling Chimera is an easy 3 minute process - you can check the instructions bellow to see how to do it.\n\n## Requirements:\n* Python 3\n* discord.py\n* mss\n* opencv-python\n* pynput\n* requests\n* python-dotenv\n* pystray\n* Pillow\n\n## Features List:\n* openurl\n* lock\n* appquitter\n* shutdown\n* sleep\n* hibernate\n* restart\n* logoff\n* cmd\n* powershell\n* screenshot\n* say\n* media\n* camera\n* echo\n* log\n* file\n* launch\n* notification\n* helpme\n\n## Features Documentation:\n\n* !helpme or !helpme *command*\n\t\u003e shows Chimera help, listing commands of shows help for a specific command, e.g: !helpme screenshot\n* !openurl *url*\n\t\u003e opens url in default browser, e.g: !openurl https://example.com\n* !lock or !lock *seconds*\n\t\u003e locks your computer immediately or with a time delay in seconds, e.g: !lock 30\n* !appquitter *Application_Name* or !appquitter *Application_Name* *minutes*\n\t\u003e quits the specified application immediately or with a time delay in minutes, e.g: !appquitter chrome 30\n* !shutdown or !shutdown *seconds*\n\t\u003e shuts down your computer immediately or with a time delay in seconds, e.g: !shutdown 30\n* !sleep or !sleep *seconds*\n\t\u003e sleeps your computer immediately or with a time delay in seconds, e.g: !sleep 30\n* !hibernate or !hibernate *seconds*\n\t\u003e hibernates your computer immediately or with a time delay in seconds, e.g: !hibernate 30\n* !restart or !restart *seconds*\n\t\u003e restarts your computer immediately or with a time delay in seconds, e.g: !restart 30\n* !logoff or !logoff *seconds*\n\t\u003e logs off your user immediately or with a time delay in seconds, e.g: !logoff 30\n\n* !cmd \"*command*\"\n\t\u003e executes *command* in cmd.exe\n* !powershell \"*command*\"\n\t\u003e executes *command* in Powershell\n\n* !screenshot or !screenshot *seconds*\n\t\u003e takes a screenshot of your computer and sends it back to you \n* !say \"*text*\"\n\t\u003e uses powershell commands and a TTS engine to make your computer say something\n\n* !media *command* or !media *command* *repeat_n_times*\n\t\u003e controls computer media playback and volume once or repeatedly, e.g: !media prev 2\n\t\tlist of commands:\n\t\t- vol-up\n\t\t- vol-down\n\t\t- vol-mute\n\t\t- next\n\t\t- prev\n\t\t- stop\n\t\t- play\n\t\t- pause\n\t\t\n* !camera *command* or !camera *command* *time*\n\t\u003e controls computer camera for taking photo or filming for a given *time* in seconds (default is 5 seconds), e.g: !camera video 10\n\t\tlist of commands:\n\t\t- video time\n\t\t- photo\n\t\t\n* !echo *status*\n\t\u003e turns on or off !cmd and !powershell command echo in chat. When turned on, the command return will be sent to chat, e.g: !echo on / !echo off\n\t\n* !log *param* or !log *param* *date*\n\t\u003e turns on or off chat logging or show log for given date (defaults to today), e.g: !log show 2018-10-16\n\n* !file *command* or !file *command* *path*\n\t\u003e browses, saves and retrieves files from or to your computer, e.g: !file relative ..\n\t\tlist of commands:\n\t\t- absolute =\u003e sets an absolute path\n\t\t- relative =\u003e sets a relative path\n\t\t- list =\u003e lists current path\n\t\t- retrieve =\u003e uploads a file to the chat\n\t\t- save =\u003e saves a file to the HD from the chat\n\t\t- download =\u003e saves a file from a direct url to the HD\n\n* !launch *shortcut*\n    \u003e launches a custom shortcut you placed in the shortcuts folder\n    \n* !notification \"*message*\"\n    \u003e sends a notification to the computer\n\nNote: Some commands may require elevated privileges on Linux.\n\n## Installation:\n\n### Text Instructions:\n1. Download \u0026 Install Python\n2. Create a bot and get its token and then get your channel ID by following these instructions: https://github.com/Chikachi/DiscordIntegration/wiki/How-to-get-a-token-and-channel-ID-for-Discord\n3. Download the repository, run setup.bat on Windows or setup.sh on Linux and put your Bot Token in the newly created .env file. \n4. Launch chimera.pyw, right click on the system tray icon and hit Connect to invite chimera to your server\n5. Enjoy!\n\n### Video tutorial:\n\n[![Video Tutorial](https://j.gifs.com/l5m85j.gif)](https://www.youtube.com/watch?v=JXqS3WaTOB4)\n\n\n\n\n\n## Contributing:\nChimera was written to be modular so one can easily modify the code and enhance it. I welcome and greatly appreciate anyone who wishes to contribute a module of their own.\nHere's how to create a Chimera module:\n\n1. Create your *_module.py under the modules directory. See lock_module.py for a good example on how to structure yours\n2. Create an entry for your modules in chimera.py. The file is full of examples.\n3. Test Chimera with your changes and make a pull request if everything works well\n4. Update the README.md file to include your new module and your github profile under Contributors\n\n\n## Credits:\n* [Habchy](https://github.com/Habchy) for writing BasicBot which was the base for chimera\n* jestemkioskiem for his great [tutorial](https://steemit.com/utopian-io/@jestemkioskiem/build-your-own-discord-bot-with-python-1-basicbot)\n\n## Contributors:\n* [Zachman61](https://github.com/Zachman61)\n* [vfcoelho](https://github.com/vfcoelho)\n* [DragosPopse](https://github.com/DragosPopse)\n* [TGlide](https://github.com/TGlide)\n* [vlad4him](https://github.com/vlad4him)\n* [sn0wmanmj](https://github.com/sn0wmanmj)\n* [cominixo01](https://github.com/cominixo01)\n* [medusalix](https://github.com/medusalix)\n* [kostino](https://github.com/kostino)\n* [GAK](https://github.com/Arvinth-Krishna)\n* [BlazerYoo](https://github.com/BlazerYoo)\n* [Aethese](https://github.com/Aethese)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedarctic%2Fchimera","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcedarctic%2Fchimera","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedarctic%2Fchimera/lists"}