https://github.com/idatsy/file-selector
Utility for selecting and copying content from directories/files
https://github.com/idatsy/file-selector
Last synced: 11 months ago
JSON representation
Utility for selecting and copying content from directories/files
- Host: GitHub
- URL: https://github.com/idatsy/file-selector
- Owner: idatsy
- Created: 2024-12-17T20:58:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-15T08:29:18.000Z (about 1 year ago)
- Last Synced: 2025-04-12T20:58:28.579Z (11 months ago)
- Language: Python
- Size: 14.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Simple CLI Directory Browser and Clipboard Snippet Tool
This is a minimal tool that allows you to navigate through a directory tree using vim-like keybindings (j/k or arrow keys), select files or directories, and copy their contents as Markdown snippets to the system clipboard.
## Features
- Navigate files and directories
- Select multiple files or entire directories
- Copies selected files' contents to the clipboard as a Markdown snippet
- Vim-like navigation (`j/k/gg/G`) and file selection (`Enter`)
## Key Bindings
- **Navigation:**
- `j` / `↓`: Move down
- `k` / `↑`: Move up
- `[count]j` or `[count]k`: Move multiple lines
- `gg`: Jump to top
- `G`: Jump to bottom or `[count]G` to jump to a specific line number
- **Selection:**
- `Enter`: Toggle selection of a file or directory (directories toggle all descendants)
- **Exit:**
- `q`: Quit
## Requirements
- Python 3.6+
- `pyperclip`
- linux
- xclip