{"id":20876235,"url":"https://github.com/0x6f677548/podshell","last_synced_at":"2025-05-12T15:32:14.532Z","repository":{"id":196952649,"uuid":"683808730","full_name":"0x6f677548/podshell","owner":"0x6f677548","description":"PodShell synchronizes your favorite terminal with your running docker containers, or ssh configurations.","archived":false,"fork":false,"pushed_at":"2024-01-06T15:12:07.000Z","size":2553,"stargazers_count":4,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-20T21:13:37.989Z","etag":null,"topics":["docker","iterm2","macos","shell","ssh","terminal","windows","windowster"],"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/0x6f677548.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}},"created_at":"2023-08-27T19:04:09.000Z","updated_at":"2024-02-02T21:18:17.000Z","dependencies_parsed_at":"2023-09-28T11:28:17.743Z","dependency_job_id":null,"html_url":"https://github.com/0x6f677548/podshell","commit_stats":null,"previous_names":["0x6f677548/podshell"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x6f677548%2Fpodshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x6f677548%2Fpodshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x6f677548%2Fpodshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0x6f677548%2Fpodshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0x6f677548","download_url":"https://codeload.github.com/0x6f677548/podshell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225141205,"owners_count":17427245,"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":["docker","iterm2","macos","shell","ssh","terminal","windows","windowster"],"created_at":"2024-11-18T06:50:30.567Z","updated_at":"2025-05-12T15:32:14.519Z","avatar_url":"https://github.com/0x6f677548.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Lint](https://go.hugobatista.com/gh/podshell/actions/workflows/lint-quick.yml/badge.svg)](https://go.hugobatista.com/gh/podshell/actions/workflows/lint-quick.yml)\n# PodShell\n\u003cimg align=\"left\" src=\"https://go.hugobatista.com/ghraw/podshell/main/resources/icon128.png\" height=\"50\" width=\"50\"/\u003e\nPodShell sychronizes your favorite terminal with your running docker containers or ssh configurations. \nJust spin up your containers, and PodShell will automatically add them to your terminal. \n\n## Supported terminals\n### iTerm2 Dynamic Profiles\n![demo-iTerm2](https://go.hugobatista.com/ghraw/podshell/main/resources/demo-iTerm2.gif)\n\n### Windows Terminal Profiles\n![demo-WindowsTerminal](https://go.hugobatista.com/ghraw/podshell/main/resources/demo-windowsTerminal.gif)\n\n## Supported pod sources\n### Docker (local)\nPodShell monitors your docker events and creates profiles for any running container.\n\n### SSH (config)\nPodShell monitors your ssh config file and creates profiles based on Host config.\n\n## Installation and usage\n### Windows\n1. Download [latest release](https://go.hugobatista.com/gh/podshell/releases/latest/download/podshell-windows.zip)\n2. Extract the zip file\n3. Run `podshell.exe` to start the application\n\nIf you prefer, a console version is also available. You can run it with `podshell-console.exe`.\n\nIf you get prompted by Windows Defender, click on \"More info\" and then \"Run anyway\" (this is because the application is not signed)\n\n### MacOS\n1. Download [latest release](https://go.hugobatista.com/gh/podshell/releases/latest/download/podshell-macos.zip)\n2. Extract the zip file\n3. Run `podshell` to start the application\n\nIf you prefer, a console version is also available. You can run it with `podshell-console`.\n\nThis application is not signed, so you will have to allow it in your security settings. To do so, go to \"System Preferences\" \u003e \"Security \u0026 Privacy\" \u003e \"General\" and click on \"Open Anyway\". You will have to do this only once. Alternatively, you can right click on the application and click on \"Open\".\n\n### Run from source\nYou can also run the application from source. To do so, you will need to have [Python \u003e=3.7 installed](https://www.python.org/downloads/). Then, you can run the following commands:\n```bash\ngit clone https://go.hugobatista.com/gh/podshell\ncd podshell\npython -m pip install -r requirements.txt\n```\nTo run the gui version, run:\n```bash\npython main.py\n```\n\nTo run the console version, run:\n```bash\npython console.py\n```\n### Build binaries for your platform\nYou can build binaries for your platform by running the following commands:\n```bash\ngit clone https://go.hugobatista.com/gh/podshell\ncd podshell\npython -m pip install -r requirements.txt\npip install pyinstaller\npip install pillow\npyinstaller podshell.spec\npyinstaller podshell-console.spec\n```\n\n### Gui Version\nWhen running on Gui, a tray icon is shown where you can activate or deactivate sources and terminals. When starting, the app detects sources and terminals installed. You can toggle on/off the sources and terminal integration. A single terminal is supported per platform (win32/MacOS) but more terminals will be integrated in the future.\n\n![system-tray-icon](https://go.hugobatista.com/ghraw/podshell/main/resources/tray-windows.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0x6f677548%2Fpodshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0x6f677548%2Fpodshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0x6f677548%2Fpodshell/lists"}