https://github.com/azizuysal/simtool
A beautiful and powerful TUI for managing iOS Simulators
https://github.com/azizuysal/simtool
go ios macos simulator tui
Last synced: 8 months ago
JSON representation
A beautiful and powerful TUI for managing iOS Simulators
- Host: GitHub
- URL: https://github.com/azizuysal/simtool
- Owner: azizuysal
- License: mit
- Created: 2025-06-09T12:55:20.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-23T20:04:43.000Z (11 months ago)
- Last Synced: 2025-09-05T05:47:02.649Z (9 months ago)
- Topics: go, ios, macos, simulator, tui
- Language: Go
- Size: 2.6 MB
- Stars: 19
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# SimTool 🛠️
A beautiful and powerful TUI for managing iOS Simulators
Navigate your iOS simulators, browse apps, explore files, and preview content—all from your terminal.
## ✨ Features
### 🚀 Simulator Management
- **List all iOS simulators** with status indicators (running/stopped)
- **Boot simulators** directly from the TUI
- **Smart filtering** to show only simulators with apps
- **Real-time search** by name, runtime, or state
### 📱 App Browsing
- **Browse installed apps** with detailed information
- **View app metadata**: Bundle ID, version, size, last modified date
- **All Apps view**: See apps from all simulators in one place
- **Open in Finder**: Quick access to app containers
- **Lightning-fast search** across all app properties
### 📁 File Explorer
- **Navigate app containers** with an intuitive file browser
- **Breadcrumb navigation** for easy orientation
- **Smart file previews** based on content type
- **Quick Finder access** for any file or folder
### 🎨 Rich File Viewing
**📝 Text Files**
- Syntax highlighting for 100+ languages
- Automatic language detection
- Theme-aware colors
- Lazy loading for large files
**🖼️ Images**
- Terminal-based previews
- Support for PNG, JPEG, GIF, WebP, BMP, TIFF
- SVG rendering with ASCII art
- Automatic format detection
**📦 Archives**
- Browse ZIP, JAR, IPA, APK contents
- Tree structure visualization
- Compression statistics
- No extraction needed
**🗄️ Databases**
- SQLite browser with table navigation
- Paginated data viewing
- Schema inspection
- Column-aligned display
### ⚡ Additional Features
- **Property List Support**: Automatic binary plist → XML conversion
- **Binary File Viewer**: Hex dump with ASCII preview
- **Dynamic Theming**: 60+ themes, auto dark/light mode switching
- **Vim Navigation**: Full keyboard control with customizable shortcuts
- **Responsive Design**: Adapts to any terminal size
- **Lightning Fast**: Instant navigation and lazy loading
## 📋 Requirements
- macOS 10.15 or later
- Xcode Command Line Tools
- Go 1.24.4 or later (for building from source)
## 🚀 Installation
### Homebrew (Recommended)
```bash
brew tap azizuysal/simtool
brew install simtool
```
### Go Install
```bash
go install github.com/azizuysal/simtool/cmd/simtool@latest
```
### Download Binary
Download from [Releases](https://github.com/azizuysal/simtool/releases) page.
### Build from Source
```bash
git clone https://github.com/azizuysal/simtool.git
cd simtool
make install
```
## 📖 Usage
### Quick Start
```bash
# Launch SimTool
simtool
# Start with all apps view
simtool --apps
```
### Keyboard Shortcuts
| Key | Action |
|-----|--------|
| `↑/↓` or `j/k` | Navigate up/down |
| `←/→` or `h/l` | Go back/enter |
| `Space` | Boot simulator / Open in Finder |
| `/` | Search mode |
| `f` | Filter (simulators with apps only) |
| `q` | Quit |
| `g/G` | Jump to top/bottom |
All shortcuts are [customizable](#configuration).
## ⚙️ Configuration
SimTool uses a TOML configuration file located at `~/.config/simtool/config.toml`.
```toml
# Start with all apps view by default
[startup]
initial_view = "all_apps"
# Theme configuration
[theme]
mode = "auto" # auto, dark, or light
dark_theme = "dracula"
light_theme = "github"
# Custom key bindings
[keys]
up = ["up", "k"]
down = ["down", "j"]
quit = ["q", "ctrl+c"]
```
Generate an example configuration:
```bash
simtool --generate-config
```
See [Configuration Guide](docs/configuration.md) for all options.
## 🎨 Themes
SimTool includes 60+ beautiful syntax highlighting themes. Popular choices:
**Dark**: `dracula`, `monokai`, `github-dark`, `nord`, `tokyo-night`
**Light**: `github`, `solarized-light`, `tango`, `papercolor-light`
List all themes:
```bash
simtool --list-themes
```
## 🤝 Contributing
Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and development process.
### Development Setup
```bash
git clone https://github.com/azizuysal/simtool.git
cd simtool
go mod download
make build
```
See [Development Guide](docs/development.md) for architecture details.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea) - The delightful TUI framework
- Syntax highlighting by [Chroma](https://github.com/alecthomas/chroma)
- Styled with [Lipgloss](https://github.com/charmbracelet/lipgloss)
## 🌟 Star History
[](https://star-history.com/#azizuysal/simtool&Date)
---
Made with ❤️ by Aziz Uysal