GitHub - Eoin-McMahon/comhad: S3 TUI client · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Eoin-McMahon
comhad
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
master
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>29 Commits<br>29 Commits
.github
.github
assets
assets
docs
docs
src
src
tests
tests
.gitignore
.gitignore
Cargo.lock
Cargo.lock
Cargo.toml
Cargo.toml
LICENSE
LICENSE
README.md
README.md
View all files
Repository files navigation
Comhad (pronounced "KOH-ad") is the Irish word for "file".
✨ Features
Ranger-style panes : local ⇄ S3 side by side, with a third pane for preview or object info.
Real previews : syntax-highlighted text, and images inline via Kitty, iTerm2 or Sixel.
Background transfers : every download, upload and zip runs as a cancellable job with live progress.
Copy, cut and paste : across directories, across panes, across backends, with ghost rows showing where things will land.
Non-destructive sync : a git-diff-style view of what will be added and updated, in either direction. Sync never deletes.
Fuzzy deep filter : / searches the listing and quietly recurses, surfacing matches from nested prefixes.
Paired directories : a bookmark remembers the local directory that goes with its bucket, so sync and downloads point at the right place on connect.
Safe by default : every write confirms first, with the destination spelled out and No preselected on delete.
📦 Installation
Requires Rust 1.85 or newer (install Rust).
📥 Install from crates.io
cargo install comhad
🏗️ Build from source
git clone https://github.com/Eoin-McMahon/Comhad.git<br>cd Comhad<br>cargo install --path ./
On Linux, clipboard support needs the X11 headers: sudo apt install libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev.
🚀 Quick start
comhad
Press a on the bookmark list to add a connection, fill in the wizard, and enter to connect.<br>That's the whole setup: no config file required. If you want one, for startup defaults, theme<br>colours or custom keybindings, you can add ~/.comhad/config.toml yourself (see the<br>Configuration section below), but it's entirely optional.
⌨️ Keys
Key<br>Action
hjkl / arrows<br>navigate; l/enter opens, h goes up
space / v<br>mark item / visual-mode range select
d / u<br>download / upload marked items
y x P<br>copy / cut / paste, in any direction
D / r<br>delete (no undo) / rename
sync dialog
fuzzy filter, with recursive deep matches
p / i<br>preview pane / info pane
L / 1-4<br>show the local pane / jump to a pane
t E ? q<br>theme / events log / help / quit
Full keybindings and what each feature does →
⚙️ Configuration
Bookmarks live in ~/.comhad/bookmarks/*.json, one per connection, and can be managed entirely<br>from the app. Everything else is optional: ~/.comhad/config.toml sets startup defaults, theme<br>colours and keybindings, and comhad works fine without it.
Configuration reference →
🧑💻 Development
cargo build --release<br>cargo test<br>cargo clippy --all-targets
Storage backends sit behind a single StorageProvider trait in src/provider/, so adding another<br>service is a matter of implementing that trait, the most useful place to start if you'd like to<br>contribute. Issues and pull requests welcome.
📄 License
MIT © Eóin McMahon
comhad (pronounced "KOH-ad") is the Irish word for "file".
About
S3 TUI client
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
star
Watchers
watching
Forks
forks
Report repository
Releases
Comhad v0.1.0: a ranger-style terminal browser for S3
Latest
Jul 22, 2026
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Rust<br>100.0%
You can’t perform that action at this time.