{"id":38548403,"url":"https://github.com/connerwill/rclonefzf","last_synced_at":"2026-01-28T23:08:51.181Z","repository":{"id":332447542,"uuid":"1133806898","full_name":"ConnerWill/rclonefzf","owner":"ConnerWill","description":"Browse rclone remote contents using fzf","archived":false,"fork":false,"pushed_at":"2026-01-14T20:38:59.000Z","size":601,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-18T06:25:37.534Z","etag":null,"topics":["cli","fzf","rclone","rclone-fzf","rclonefzf","tui"],"latest_commit_sha":null,"homepage":"https://aur.archlinux.org/packages/rclonefzf","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ConnerWill.png","metadata":{"files":{"readme":"docs/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,"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":"2026-01-13T21:01:40.000Z","updated_at":"2026-01-14T20:39:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ConnerWill/rclonefzf","commit_stats":null,"previous_names":["connerwill/rclonefzf"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ConnerWill/rclonefzf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnerWill%2Frclonefzf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnerWill%2Frclonefzf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnerWill%2Frclonefzf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnerWill%2Frclonefzf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ConnerWill","download_url":"https://codeload.github.com/ConnerWill/rclonefzf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ConnerWill%2Frclonefzf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28615545,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T21:52:42.722Z","status":"ssl_error","status_checked_at":"2026-01-20T21:52:20.513Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","fzf","rclone","rclone-fzf","rclonefzf","tui"],"created_at":"2026-01-17T07:27:33.644Z","updated_at":"2026-01-28T23:08:51.172Z","avatar_url":"https://github.com/ConnerWill.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg width=\"720\" height=\"480\" src=\"/docs/images/demo-screenshot.png\"\u003e\n\n# rclonefzf\n\n\u003e ***rclonefzf** is an interactive terminal UI for browsing and viewing files on **[rclone][rclone-url]** remotes using **[fzf][fzf-url]***\n\n[![Shellcheck][shellcheck-badge]][shellcheck-workflow]\n[![GitHub last commit][github-last-commit-badge]][github-commits]\n[![GitHub issues][github-issues-badge]][github-issues]\n[![GitHub repo size][github-repo-size-badge]][github-repo]\n[![GitHub top language][github-top-language-badge]][github-repo]\n[![GitHub language count][github-language-count-badge]][github-repo]\n[![License][license-badge]][license]\n[![GitHub Release Version][github-release-badge]][github-release-url]\n[![AUR Version][aur-version-badge]][aur-url]\n[![GitLab][gitlab-badge]][gitlab]\n\u003c!--[![GitHub repo stars][github-repo-stars-badge]][github-repo]\n[![GitHub repo downloads][github-repo-downloads-badge]][github-repo]--\u003e\n\n\u003c/div\u003e\n\n\u003cimg width=\"100%\" src=\"https://raw.githubusercontent.com/ConnerWill/Project-Template/main/assets/lines/rainbow.png\"\u003e\n\n# Description\n\nrclonefzf is an interactive terminal UI for browsing and viewing files on rclone remotes using **[fzf][fzf-url]**\n\nIt provides a fast, keyboard-driven interface to select configured rclone remotes, recursively browse files, preview file contents inline, and manage selections — all from the terminal.\n\n\n\u003cimg width=\"100%\" src=\"https://raw.githubusercontent.com/ConnerWill/Project-Template/main/assets/lines/rainbow.png\"\u003e\n\n# Table of Contents\n\n\u003c!--toc:start--\u003e\n- [rclonefzf](#rclonefzf)\n- [Description](#description)\n- [Table of Contents](#table-of-contents)\n- [Screenshots](#screenshots)\n  - [Features](#features)\n  - [Requirements](#requirements)\n  - [Installation](#installation)\n    - [AUR](#aur)\n    - [Git](#git)\n  - [Usage](#usage)\n    - [Command Line Options](#command-line-options)\n    - [Keybindings](#keybindings)\n  - [Configuration](#configuration)\n    - [Configuration Files](#configuration-files)\n    - [Configuration Options](#configuration-options)\n  - [See Also](#see-also)\n  - [Contributing](#contributing)\n  - [Donate](#donate)\n\u003c!--toc:end--\u003e\n\n\u003cimg width=\"100%\" src=\"https://raw.githubusercontent.com/ConnerWill/Project-Template/main/assets/lines/rainbow.png\"\u003e\n\n# Screenshots\n\n \u003cdiv align=\"center\"\u003e\n\n| ![demo screenshot](/docs/images/demo-screenshot.png) | ![demo screenshot_2](/docs/images/demo-screenshot-2.png) |\n| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |\n\n\u003c/div\u003e\n\n\n## Features\n\n* Interactive menu for selecting rclone remotes\n* Recursive file browsing with configurable depth\n* Inline file preview using `rclone cat`\n* Multi-select support via fzf\n* Toggleable preview window\n* Multiple built-in color themes\n* Configurable layout, borders, and keybindings\n* XDG-compliant configuration file support\n\n## Requirements\n\n- `rclone`\n- `fzf`\n\n## Installation\n\n### AUR\n\n```bash\nyay -S rclonefzf\n```\n\n### Git\n\nClone the repository and make the script executable:\n\n```bash\ngit clone https://github.com/connerwill/rclonefzf.git\ncd rclonefzf\nchmod +x bin/rclonefzf\n```\n\nOptionally, move it to a directory in your PATH:\n\n```bash\nsudo install -Dm755 \"bin/rclonefzf\" \"/usr/local/bin/rclonefzf\"  # Main executable\nsudo install -Dm644 \"docs/README.md\" \"/usr/share/doc/rclonefzf/README.md\"  # Documentation\nsudo install -Dm644 \"docs/rclonefzf.1\" \"/usr/share/man/man1/rclonefzf.1\"  # Man page\nsudo install -Dm644 \"LICENSE\" \"/usr/share/licenses/rclonefzf/LICENSE\"  # License\nsudo install -Dm644 \"completion/_rclonefzf\" \"/usr/share/zsh/site-functions/_rclonefzf\"  # ZSH completion\nsudo install -Dm644 \"completion/rclonefzf_completion.sh\" \"/usr/share/bash-completion/completions/rclonefzf\"  # Bash completion\n```\n\n## Usage\n\nLaunch the interactive interface:\n\n```bash\nrclonefzf\n```\n\nLaunch with an initial search query:\n\n```bash\nrclonefzf \"query\"\n```\n\n### Command Line Options\n\n| Option | Description |\n|--------|-------------|\n| `-k`, `--keybindings` | Show keybindings and exit |\n| `-i`, `--init-config` | Install example configuration file |\n| `-s`, `--show-config` | Show example configuration file content |\n| `-v`, `--verbose` | Show verbose output |\n| `-h` | Show short help |\n| `--help` | Show full help |\n| `--help-man` | Show manpage help |\n| `-V`, `--version` | Show version |\n\n### Keybindings\n\n| Key | Action |\n|-----|--------|\n| \u003ckbd\u003e↑\u003c/kbd\u003e | Move up |\n| \u003ckbd\u003e↓\u003c/kbd\u003e | Move down |\n| \u003ckbd\u003ePGUP\u003c/kbd\u003e | Move up one page |\n| \u003ckbd\u003ePGDN\u003c/kbd\u003e | Move down one page |\n| \u003ckbd\u003eHOME\u003c/kbd\u003e | Move to first |\n| \u003ckbd\u003eEND\u003c/kbd\u003e | Move to last |\n| \u003ckbd\u003eENTER\u003c/kbd\u003e | Perform action on selection |\n| \u003ckbd\u003eTAB\u003c/kbd\u003e | Select item |\n| \u003ckbd\u003eShift\u003c/kbd\u003e+\u003ckbd\u003eTAB\u003c/kbd\u003e | Unselect item |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003ea\u003c/kbd\u003e | Select all items |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003ed\u003c/kbd\u003e | Deselect all items |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003es\u003c/kbd\u003e | Download selection |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003el\u003c/kbd\u003e | Clear search query |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003eBackspace\u003c/kbd\u003e | Clear search query |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003e/\u003c/kbd\u003e | Change layout |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003ev\u003c/kbd\u003e | Toggle preview window |\n| \u003ckbd\u003e?\u003c/kbd\u003e | Show keybindings |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003ec\u003c/kbd\u003e | Exit rclonefzf |\n| \u003ckbd\u003eCTRL\u003c/kbd\u003e+\u003ckbd\u003ew\u003c/kbd\u003e | Exit rclonefzf |\n| \u003ckbd\u003eESC\u003c/kbd\u003e | Exit rclonefzf |\n\n## Configuration\n\n### Configuration Files\n\nrclonefzf looks for configuration files in this order (uses the first file found):\n\n- `$XDG_CONFIG_HOME/rclonefzf/rclonefzf.conf`\n- `$HOME/.config/rclonefzf/rclonefzf.conf`\n- `$HOME/.rclonefzf.conf`\n\n### Configuration Options\n\n- `THEME` — Color theme *[`string`]* *(`default`)* *(`default`, `light`, `tokyo-night`, `neon`)*\n- `PREVIEW_WINDOW` — fzf preview window layout and size *[`string`]* *(`right:60%:wrap`)*\n- `ENABLE_PREVIEW` — Show preview window *[`bool`]* *(`true`)*\n- `LAYOUT` — fzf layout *[`string`]* *(`reverse`)* *(`default`, `reverse`)*\n- `BORDER` — fzf border style *[`string`]* *(`rounded`)* *(`default`, `rounded`)*\n- `VERBOSE` — Enable verbose logging *[`bool`]* *(`false`)*\n- `RCLONEFZF_PAGER` — Pager *[`string`]* *(`less`)*\n- `RCLONE_MAX_DEPTH` — Max depth for directory browsing *[`integer`]* *(`10`)*\n- `RCLONEFZF_DOWNLOADS_DIR` - Download directory *[`string`]* *(`~/downloads/rclonefzf`)*\n- `NO_COLOR` - Do not use color for output *[`bool`]*\n\n## See Also\n\n- [rclone][rclone-url]\n- [fzf][fzf-url]\n- [yayfzf][yayfzf-url]\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand contributing section\u003c/summary\u003e\n\n\u003cbr\u003e\n\n\u003e Any contributions you make are **greatly appreciated**.\n\n\u003e \u003e If you want to contribute, please fork this repo and create a pull request.\n\n1. Fork the Project\n2. Create your Feature Branch\n\n```console\ngit checkout -b AmazingNewFeature\n```\n\n3. Commit your Changes\n\n```console\ngit commit -m 'Description of the amazing feature you added'\n```\n\n4. Push to the Branch\n\n```console\ngit push origin AmazingNewFeature\n```\n\n5. Then open a pull request `:)`\n\n\u003e \u003e If you experience any bugs/issues or have and suggestions, you can simply open an issue `:)`\n\n\u003c/details\u003e\n\n## Donate\n\n\u003ca href=\"https://connerwill.com/static/img/xmr-qr-connerwill.com.png\"\u003e\u003cimg src=\"https://connerwill.com/static/img/xmr.svg\" alt=\"Monero (XMR) icon and wallet QR code\" width=\"2%\" height=\"2%\"\u003e XMR\u003c/a\u003e :  \u003ccode\u003e86tE67soBqFb5fxNGgC4HLdwZXebP42ewfBwfKyMDKvFbgA7T8p4g4T5BBNA9LNbwaVafup973w41PdvCS7bbj6gTNQpCh1\u003c/code\u003e\n\n\u003ca href=\"https://connerwill.com\"\u003e\u003cimg src=\"https://connerwill.com/static/img/btc.svg\" alt=\"₿\" width=\"2%\" height=\"2%\"\u003e\u003c/a\u003e BTC : \u003ccode\u003ebc1qpg5d69n2knsete7vw7f2vqpkg4a0faq9rc6se0\u003c/code\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003cimg width=\"100%\" src=\"https://raw.githubusercontent.com/ConnerWill/Project-Template/main/assets/lines/rainbow.png\"\u003e\n\n\u003c!-- LINKS --\u003e\n[github-repo]: https://github.com/ConnerWill/rclonefzf\n[shellcheck-badge]: https://github.com/ConnerWill/rclonefzf/actions/workflows/shellcheck.yml/badge.svg\n[shellcheck-workflow]: https://github.com/ConnerWill/rclonefzf/actions/workflows/shellcheck.yml\n[github-top-language-badge]: https://img.shields.io/github/languages/top/ConnerWill/rclonefzf\n[github-language-count-badge]: https://img.shields.io/github/languages/count/ConnerWill/rclonefzf\n[github-last-commit-badge]: https://img.shields.io/github/last-commit/ConnerWill/rclonefzf\n[github-commits]: https://github.com/ConnerWill/rclonefzf/commits/main\n[github-issues-badge]: https://img.shields.io/github/issues-raw/ConnerWill/rclonefzf\n[github-issues]: https://github.com/ConnerWill/rclonefzf/issues\n[github-repo-size-badge]: https://img.shields.io/github/repo-size/ConnerWill/rclonefzf\n[gitlab-badge]: https://img.shields.io/static/v1?label=gitlab\u0026logo=gitlab\u0026color=E24329\u0026message=mirrored\n[gitlab]: https://gitlab.com/ConnerWill/rclonefzf\n[license-badge]: https://img.shields.io/github/license/ConnerWill/rclonefzf\n[license]: https://github.com/ConnerWill/rclonefzf/blob/main/docs/LICENSE\n[github-repo-stars-badge]: https://img.shields.io/github/stars/ConnerWill/rclonefzf?style=social\n[github-repo-downloads-badge]: https://img.shields.io/github/downloads/ConnerWill/rclonefzf/total?style=social\n[github-release-badge]: https://img.shields.io/github/v/release/ConnerWill/rclonefzf\n[github-release-url]: https://github.com/ConnerWill/rclonefzf/releases\n[aur-version-badge]: https://img.shields.io/aur/version/rclonefzf\n[aur-url]: https://aur.archlinux.org/packages/rclonefzf\n\n[rainbow-line]: https://raw.githubusercontent.com/ConnerWill/Project-Template/main/assets/lines/rainbow.png\n[wiki-url]: https://github.com/ConnerWill/rclonefzf/wiki\n[wiki-customization-url]: https://github.com/ConnerWill/rclonefzf/wiki/Customization\n[wiki-installation-url]: https://github.com/ConnerWill/rclonefzf/wiki/Installation\n[wiki-screenshots-url]: https://github.com/ConnerWill/rclonefzf/wiki/Screenshots\n\n[fzf-url]: https://github.com/junegunn/fzf\n[yayfzf-url]: https://github.com/ConnerWill/yayfzf\n[rclonefzf-url]: https://github.com/ConnerWill/rclonefzf\n[rclone-url]: https://rclone.org\n[rclonefzf-source]: https://github.com/ConnerWill/rclonefzf/blob/main/bin/rclonefzf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnerwill%2Frclonefzf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconnerwill%2Frclonefzf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconnerwill%2Frclonefzf/lists"}