{"id":29303055,"url":"https://github.com/azizuysal/simtool","last_synced_at":"2025-10-04T16:56:43.039Z","repository":{"id":302874960,"uuid":"998909955","full_name":"azizuysal/simtool","owner":"azizuysal","description":"A beautiful and powerful TUI for managing iOS Simulators","archived":false,"fork":false,"pushed_at":"2025-07-23T20:04:43.000Z","size":2725,"stargazers_count":19,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-05T05:47:02.649Z","etag":null,"topics":["go","ios","macos","simulator","tui"],"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/azizuysal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-09T12:55:20.000Z","updated_at":"2025-08-04T21:52:34.000Z","dependencies_parsed_at":"2025-07-04T15:15:22.447Z","dependency_job_id":"6727fd42-ba52-4230-ade4-4924cd8464ab","html_url":"https://github.com/azizuysal/simtool","commit_stats":null,"previous_names":["azizuysal/simtool"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/azizuysal/simtool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azizuysal%2Fsimtool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azizuysal%2Fsimtool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azizuysal%2Fsimtool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azizuysal%2Fsimtool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azizuysal","download_url":"https://codeload.github.com/azizuysal/simtool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azizuysal%2Fsimtool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278343085,"owners_count":25971399,"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","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["go","ios","macos","simulator","tui"],"created_at":"2025-07-07T00:39:19.453Z","updated_at":"2025-10-04T16:56:42.996Z","avatar_url":"https://github.com/azizuysal.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# SimTool 🛠️\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-macOS-blue\" alt=\"macOS\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/go-%3E%3D1.24.4-00ADD8?logo=go\" alt=\"Go\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/azizuysal/simtool\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/azizuysal/simtool\" alt=\"Release\"\u003e\n  \u003ca href=\"https://codecov.io/gh/azizuysal/simtool\"\u003e\u003cimg src=\"https://codecov.io/gh/azizuysal/simtool/branch/main/graph/badge.svg\" alt=\"codecov\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://sonarcloud.io/summary/new_code?id=azizuysal_simtool\"\u003e\u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=azizuysal_simtool\u0026metric=alert_status\" alt=\"Quality Gate Status\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/azizuysal/simtool/total\" alt=\"Downloads\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA beautiful and powerful TUI for managing iOS Simulators\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Navigate your iOS simulators, browse apps, explore files, and preview content—all from your terminal.\n\u003c/p\u003e\n\n![SimTool Demo](demo.gif)\n\n## ✨ Features\n\n### 🚀 Simulator Management\n- **List all iOS simulators** with status indicators (running/stopped)\n- **Boot simulators** directly from the TUI\n- **Smart filtering** to show only simulators with apps\n- **Real-time search** by name, runtime, or state\n\n### 📱 App Browsing  \n- **Browse installed apps** with detailed information\n- **View app metadata**: Bundle ID, version, size, last modified date\n- **All Apps view**: See apps from all simulators in one place\n- **Open in Finder**: Quick access to app containers\n- **Lightning-fast search** across all app properties\n\n### 📁 File Explorer\n- **Navigate app containers** with an intuitive file browser\n- **Breadcrumb navigation** for easy orientation\n- **Smart file previews** based on content type\n- **Quick Finder access** for any file or folder\n\n### 🎨 Rich File Viewing\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n**📝 Text Files**\n- Syntax highlighting for 100+ languages\n- Automatic language detection\n- Theme-aware colors\n- Lazy loading for large files\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n**🖼️ Images**\n- Terminal-based previews\n- Support for PNG, JPEG, GIF, WebP, BMP, TIFF\n- SVG rendering with ASCII art\n- Automatic format detection\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n**📦 Archives**\n- Browse ZIP, JAR, IPA, APK contents\n- Tree structure visualization\n- Compression statistics\n- No extraction needed\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n**🗄️ Databases**\n- SQLite browser with table navigation\n- Paginated data viewing\n- Schema inspection\n- Column-aligned display\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### ⚡ Additional Features\n- **Property List Support**: Automatic binary plist → XML conversion\n- **Binary File Viewer**: Hex dump with ASCII preview\n- **Dynamic Theming**: 60+ themes, auto dark/light mode switching\n- **Vim Navigation**: Full keyboard control with customizable shortcuts\n- **Responsive Design**: Adapts to any terminal size\n- **Lightning Fast**: Instant navigation and lazy loading\n\n## 📋 Requirements\n\n- macOS 10.15 or later\n- Xcode Command Line Tools\n- Go 1.24.4 or later (for building from source)\n\n## 🚀 Installation\n\n### Homebrew (Recommended)\n```bash\nbrew tap azizuysal/simtool\nbrew install simtool\n```\n\n### Go Install\n```bash\ngo install github.com/azizuysal/simtool/cmd/simtool@latest\n```\n\n### Download Binary\nDownload from [Releases](https://github.com/azizuysal/simtool/releases) page.\n\n### Build from Source\n```bash\ngit clone https://github.com/azizuysal/simtool.git\ncd simtool\nmake install\n```\n\n## 📖 Usage\n\n### Quick Start\n```bash\n# Launch SimTool\nsimtool\n\n# Start with all apps view\nsimtool --apps\n```\n\n### Keyboard Shortcuts\n\n| Key | Action |\n|-----|--------|\n| `↑/↓` or `j/k` | Navigate up/down |\n| `←/→` or `h/l` | Go back/enter |\n| `Space` | Boot simulator / Open in Finder |\n| `/` | Search mode |\n| `f` | Filter (simulators with apps only) |\n| `q` | Quit |\n| `g/G` | Jump to top/bottom |\n\nAll shortcuts are [customizable](#configuration).\n\n## ⚙️ Configuration\n\nSimTool uses a TOML configuration file located at `~/.config/simtool/config.toml`.\n\n```toml\n# Start with all apps view by default\n[startup]\ninitial_view = \"all_apps\"\n\n# Theme configuration\n[theme]\nmode = \"auto\"  # auto, dark, or light\ndark_theme = \"dracula\"\nlight_theme = \"github\"\n\n# Custom key bindings\n[keys]\nup = [\"up\", \"k\"]\ndown = [\"down\", \"j\"]\nquit = [\"q\", \"ctrl+c\"]\n```\n\nGenerate an example configuration:\n```bash\nsimtool --generate-config\n```\n\nSee [Configuration Guide](docs/configuration.md) for all options.\n\n## 🎨 Themes\n\nSimTool includes 60+ beautiful syntax highlighting themes. Popular choices:\n\n**Dark**: `dracula`, `monokai`, `github-dark`, `nord`, `tokyo-night`  \n**Light**: `github`, `solarized-light`, `tango`, `papercolor-light`\n\nList all themes:\n```bash\nsimtool --list-themes\n```\n\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and development process.\n\n### Development Setup\n```bash\ngit clone https://github.com/azizuysal/simtool.git\ncd simtool\ngo mod download\nmake build\n```\n\nSee [Development Guide](docs/development.md) for architecture details.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) - The delightful TUI framework\n- Syntax highlighting by [Chroma](https://github.com/alecthomas/chroma)\n- Styled with [Lipgloss](https://github.com/charmbracelet/lipgloss)\n\n## 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=azizuysal/simtool\u0026type=Date)](https://star-history.com/#azizuysal/simtool\u0026Date)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by \u003ca href=\"https://github.com/azizuysal\"\u003eAziz Uysal\u003c/a\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazizuysal%2Fsimtool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazizuysal%2Fsimtool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazizuysal%2Fsimtool/lists"}