{"id":16800248,"url":"https://github.com/abiosoft/bgrun","last_synced_at":"2025-07-27T10:37:40.304Z","repository":{"id":137635419,"uuid":"152797147","full_name":"abiosoft/bgrun","owner":"abiosoft","description":"Run processes in background","archived":false,"fork":false,"pushed_at":"2018-10-14T10:46:37.000Z","size":22,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T21:13:38.686Z","etag":null,"topics":["process","runner"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abiosoft.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-10-12T19:14:01.000Z","updated_at":"2023-11-05T19:30:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"b0988be7-5306-43d0-bb9d-23bbdac84f6f","html_url":"https://github.com/abiosoft/bgrun","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/abiosoft%2Fbgrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fbgrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fbgrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abiosoft%2Fbgrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abiosoft","download_url":"https://codeload.github.com/abiosoft/bgrun/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248322237,"owners_count":21084333,"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":["process","runner"],"created_at":"2024-10-13T09:31:48.725Z","updated_at":"2025-04-11T00:31:52.718Z","avatar_url":"https://github.com/abiosoft.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bgrun\n\nA simple tool to start a process in background and get the pid.\n\n## Usage\n\n```txt\n$ bgrun -l ping.log ping 1.1.1.1\n1234\n\n$ tail -f ping.log\n64 bytes from 1.1.1.1: icmp_seq=1 ttl=57 time=11.1 ms\n64 bytes from 1.1.1.1: icmp_seq=2 ttl=57 time=12.4 ms\n```\n\nThe process pid and log file can be used to monitor and terminate the process.\n\n### List running commands\n\n```txt\nbgrun -r\n[{\"pid\": 1234, \"command\": \"ping 1.1.1.1\", \"log_file\": \"ping.log\"}]\n```\n\n### Help\n\nFor full usage\n\n```txt\n$ bgrun -h\n\nusage: bgrun [-h] [-l LOG_FILE] [-r] [-d] [-i] [-f] [command] ...\n\noptional arguments:\n  -h, --help            show this help message and exit\n\nclient:\n  -l LOG_FILE, --log-file LOG_FILE\n                        file to direct command output to, otherwise output is\n                        discarded.\n  command               command to run.\n  args                  arguments to pass to command.\n  -r, --running         list running commands, the output is json format.\n\ndaemon:\n  -d, --daemon          start daemon.\n  -i, --ignore          ignore running commands when daemon exits. By default,\n                        bgrun terminates all running commands on exit.\n  -f, --force           forcefully start even if the socket file exists. This\n                        can be as a result of another bgrun daemon running, or\n                        a previously running daemon did not terminate\n                        gracefully.\n\n```\n\n## Install\n\n* copy `bgrun` \u0026\u0026 `bgrun.py` to a directory in `$PATH`\n* start daemon with `bgrun --daemon`\n\nThere is an helper install script that works for systemd based Linux.\n\n```sh\ngit clone https://github.com/abiosoft/bgrun\ncd bgrun \u0026\u0026 ./install.sh\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabiosoft%2Fbgrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabiosoft%2Fbgrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabiosoft%2Fbgrun/lists"}