{"id":41991523,"url":"https://github.com/gentee/run-buttons","last_synced_at":"2026-01-26T00:41:03.972Z","repository":{"id":64303883,"uuid":"219912060","full_name":"gentee/run-buttons","owner":"gentee","description":"Desktop server for Run buttons mobile client. It allows you to run desktop applications from the phone.","archived":false,"fork":false,"pushed_at":"2025-07-10T06:05:42.000Z","size":1073,"stargazers_count":13,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-10T14:55:28.312Z","etag":null,"topics":["mobile","remote-desktop","remote-execution","remote-shell"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/gentee.png","metadata":{"files":{"readme":"README-ru.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-06T04:31:37.000Z","updated_at":"2025-07-10T06:05:46.000Z","dependencies_parsed_at":"2024-06-20T05:41:10.379Z","dependency_job_id":"84ced5c3-6b66-4187-a615-9d4d9e223ed1","html_url":"https://github.com/gentee/run-buttons","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gentee/run-buttons","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gentee%2Frun-buttons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gentee%2Frun-buttons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gentee%2Frun-buttons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gentee%2Frun-buttons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gentee","download_url":"https://codeload.github.com/gentee/run-buttons/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gentee%2Frun-buttons/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28763011,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T00:37:26.264Z","status":"ssl_error","status_checked_at":"2026-01-26T00:37:25.959Z","response_time":113,"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":["mobile","remote-desktop","remote-execution","remote-shell"],"created_at":"2026-01-26T00:41:03.239Z","updated_at":"2026-01-26T00:41:03.963Z","avatar_url":"https://github.com/gentee.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Run Buttons\n\nПрограмма Run Buttons позволяет вам запускать приложения на компьютере с мобильного телефона. Программа состоит из двух частей - приложения, которое необходимо запустить на компьютере и приложения для Android, которое необходимо установить на телефон. Для соединения компьютера и телефона нужно, чтобы телефон подключился по Wi-Fi к той же сети, к которой подключен компьютер.\nДанный репозитарий содержит исходный код и готовые приложения для запуска на компьютере. Исходный код и приложение для мобильного телефона находится в репозитарии [github.com/gentee/run_buttons_phone](https://github.com/gentee/run_buttons_phone).\n\n## Скачать\n\nRun Buttons является **кросс-платформенным бесплатным приложением** с открытыми исходными текстами. Вы можете самостоятельно скомпилировать десктоп приложение или скачать готовые исполняемые файлы для вашей платформы.\n\n- [Linux amd64](https://github.com/gentee/run-buttons/releases/download/v1.0.0/run-buttons-1.0.0-linux-amd64.zip)\n- [Windows amd64](https://github.com/gentee/run-buttons/releases/download/v1.0.0/run-buttons-1.0.0-windows-amd64.zip)\n- [macOS amd64](https://github.com/gentee/run-buttons/releases/download/v1.0.0/run-buttons-1.0.0-darwin-amd64.zip)\n\nПрочие дистрибутивы для Linux, macOS, Windows находятся [здесь](https://github.com/gentee/run-buttons/releases).\n\n## Mobile client\n\n[\u003cimg alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width=\"250\"/\u003e](https://play.google.com/store/apps/details?id=net.gentee.run_buttons_phone\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1)\n- **[Run Buttons клиент для Android](https://github.com/gentee/run_buttons_phone)**\n\n## Ссылки\n\n- [Documentation](README.md)\n\n### Youtube\n[![Как это работает](https://img.youtube.com/vi/ipd8pMGdaSs/0.jpg)](https://www.youtube.com/watch?v=ipd8pMGdaSs)\n\n## Шаг 1. Создайте файл конфигурации\n\nПеред запуском программы вам необходимо создать файл конфигурации **run-buttons.yaml**. Он должен находится в той же директории, что и программа. Вы можете переименовать этот файл и хранить его где угодно, но в этом случае, вы должны указывать полное его имя в параметре при запуске.\n\n```\n# default config file\n./run-buttons\n# custom config file\n./run-buttons /home/user/mybuttons.cfg\n```\n\n## Шаг 2. Настройка файла конфигурации\n\nФайл конфигурации должен иметь формат YAML. Рассмотрим все параметры, которые можно указать в файле конфигурации.  \n\n**password**  \nПароль, не является обязательным, но крайне рекомендуется его указывать.  \n\n**port**  \nПо умолчанию, используется порт *1321*. Вы можете указать другой порт, но в этом случае этот же порт необходимо будет указывать вместе с IP-адресом при подключении с мобильного телефона.\n\n**logfile**  \nПо умолчанию, вся информация о подключениях и запусках выводится на консоль. Вы можете указать лог-файл, для записи этой информации на диск. \n\n**defcolor**  \nМожно указывать цвет иконки для каждой кнопки. Если он не определен, то будет использоваться данный RGB цвет. По умолчанию, *0x006699*.\n\n**deficon**  \nМожно указывать иконку для каждой кнопки. Если иконка не определена, то будет использоваться указанная иконка. По умолчанию, *play_circle_outline*.  Необходимо указывать имя из [Material Design Icons](https://material.io/resources/icons/?style=baseline). \n\n**devices**  \nДля безопасности, рекомендуем указать в этом параметре список уникальных идентификаторов мобильных устройств, которые могут подключаться к компьютеру.  В этом случае, подключение с других устройств будет невозможно, даже зная пароль. Уникальный идентификатор устройства показывается на странице логина в мобильном приложении.\n\n**btns**  \nЭтот параметр содержит список кнопок для запуска приложений. Это единственный обязательный параметр.  Каждая кнопка может иметь следующие параметры:\n\n  * *cmd* - запускаемое приложение. Обязательный параметр.\n  * *params* - массив параметров командной строки\n  * *dir* - рабочая директория\n  * *title* - заголовок кнопки. Если не указан, то на кнопке будет показываться имя запускаемого приложения.\n  * *desc* - дополнительное описание, которое показывается под заголовком кнопки.\n  * *color* - RGB цвет иконки.\n  * *icon* - имя Material Design иконки.\n\nПример конфигурации\n``` yaml\npassword: 1234\nlogfile: run-buttons.log\ndevices: [a3a454fa41a4fc0a]\n\nbtns:\n  - cmd: gnome-calculator\n    title: Calculator\n    icon: view_module\n  - cmd: gucharmap\n    title: Character Map\n  - cmd: gnome-terminal\n    title: New Terminal\n    icon: desktop-windows\n    desc: Open a new terminal\n  - cmd: xdg-open\n    params: [https://ru.wikipedia.org/]\n    title: Wikipedia\n    icon: language\n    color: 0x33ccff\n  - cmd: xdg-open\n    params: \n      - https://github.com/gentee/run_buttons_phone\n    title: Run Buttons\n    desc: Site of the mobile client\n    icon: play_circle_filled\n    color: 0x669900\n```\n\n## Шаг 3. Запуск\n\nПосле того как вы создали файл конфигурации с кнопками для запуска приложений, вы можете запустить программу **Run Buttons**. Если все настройки были указаны верно, то она выведет примерно следующее. \n\n![Run buttons](start.png)\n\nЗдесь вы видите IP-адрес, который необходимо будет указать в мобильном приложении. Если вы будете вносить изменения в файл конфигурации, то вы должны перезапускать программу. В мобильном приложении достаточно нажать на кнопку обновления.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgentee%2Frun-buttons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgentee%2Frun-buttons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgentee%2Frun-buttons/lists"}