https://github.com/guicybercode/hitotui
A beautiful, colorful terminal file manager inspired by yazi, built with Go and Bubbletea. Features dual-pane interface, vim-style navigation, file preview, and a modern TUI design.
https://github.com/guicybercode/hitotui
aesthetic bubbletea golang linux rice tui
Last synced: about 1 month ago
JSON representation
A beautiful, colorful terminal file manager inspired by yazi, built with Go and Bubbletea. Features dual-pane interface, vim-style navigation, file preview, and a modern TUI design.
- Host: GitHub
- URL: https://github.com/guicybercode/hitotui
- Owner: guicybercode
- License: mit
- Created: 2025-10-31T14:49:51.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-31T16:51:18.000Z (8 months ago)
- Last Synced: 2025-10-31T18:23:28.654Z (8 months ago)
- Topics: aesthetic, bubbletea, golang, linux, rice, tui
- Language: Go
- Homepage:
- Size: 2.68 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## hitotui
A beautiful, colorful terminal file manager inspired by [yazi](https://github.com/sxyazi/yazi), built with Go and [Bubbletea](https://github.com/charmbracelet/bubbletea).
## Features
- **Dual-pane interface**: Navigate files on the left, preview content on the right
- **Vim-style navigation**: Use arrow keys or `j`/`k` to move up and down
- **File preview**: View text files, directory information, and file metadata
- **Beautiful UI**: Colorful, modern terminal interface with responsive design
- **Hidden files toggle**: Press `.` to show/hide hidden files
- **Keyboard shortcuts**: Intuitive key bindings for efficient file management
## Installation
### From Source
```bash
git clone https://github.com/guicybercode/hitotui
cd hitotui
go build -o hitotui
./hitotui
```
### Prerequisites
- Go 1.21 or later
- A terminal emulator with color support
## Usage
Launch hitotui from your terminal:
```bash
./hitotui
```
Or navigate to a specific directory:
```bash
./hitotui /path/to/directory
```
## Keyboard Shortcuts
| Key | Action |
|-----|--------|
| `↑` / `k` | Move selection up |
| `↓` / `j` | Move selection down |
| `Enter` | Open directory or file |
| `Backspace` / `h` | Go to parent directory |
| `.` | Toggle hidden files |
| `q` / `Ctrl+C` | Quit |
## Architecture
```
hitotui/
├── main.go # Application entry point
├── internal/
│ ├── app/ # Main Bubbletea model
│ ├── ui/ # UI components (layout, file list, preview)
│ ├── fs/ # File system operations
│ └── actions/ # File operations (copy, move, delete)
└── pkg/
└── config/ # Configuration management
```
## Technologies
- **Bubbletea**: Terminal UI framework for Go
- **Lipgloss**: Styling and layout engine
- **Go standard library**: File system operations
## Development
### Building
```bash
go build -o hitotui
```
### Running
```bash
go run main.go
```
## Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.
## License
MIT License - see LICENSE file for details.
## Author
Created by [Guilherme (@guicybercode)](https://github.com/guicybercode)
Connect with me on [LinkedIn](https://www.linkedin.com/in/guilherme-monteiro-3653b51a7)
---
**하나님은 나의 빛이요, 나의 구원이시니 내가 누구를 두려워하랴.**