CLI Files Manager ^v1.0.0

• Recursive Size Analysis — Scan folders and see detailed size breakdowns with progress bar
• Safe Deletion — Delete files and folders with confirmation prompts
• Text File Viewer — View any text file with paging support (less/more)
• Hex/Binary Viewer — Examine raw file contents in hexadecimal format
• MD5 Hash Calculator — Generate and verify file checksums
• Open Location — Open current or selected path in system file explorer
• Device-Wide Search — Find files by pattern with preview and navigation
• Interactive Directory Navigation — Change working directory with tab completion
• Detailed File Info — View metadata, timestamps, sizes, and MD5
• Desktop Integration — Create .desktop entries for app menu and desktop
• Color-Coded Output — Beautiful terminal UI with intuitive color coding
• Tab Completion — Auto-complete file and directory paths

Dependencies

# Arch Linux
sudo pacman -S python python-pip

# Debian/Ubuntu
sudo apt install python3 python3-pip

# Fedora/RHEL
sudo dnf install python3 python3-pip

# No additional Python packages required — uses only standard library!

Setup from Repository

cd ~
git clone https://github.com/aixandrolab/cli-files-manager.git
cd cli-files-manager
python app.py

Analyze Folder Size

[████████████████████████████████████████] 1250/1250 files
📁 TOTAL SIZE: 2.45 GB

Search Files Device-Wide

🔍 Enter search pattern: *.mp3
📁 Search root: /home/user/Music
Results show all matches with sizes and paths

Calculate MD5 Hash

MD5 Hash of file.iso:
a1b2c3d4e5f678901234567890123456

View Binary File in Hex

00000000  89 50 4e 47 0d 0a 1a 0a  00 00 00 0d 49 48 44 52  .PNG........IHDR
00000010  00 00 02 00 00 00 02 00  08 06 00 00 00  ... etc

Create Desktop Integration

✅ SUCCESS
✓ Application Menu: /home/user/.local/share/applications/cli-files-manager.desktop
✓ Desktop: /home/user/Desktop/cli-files-manager.desktop

cli-files-manager/
├── app.py                     # Main entry point
├── utils/
│   ├── asciiart.py            # ASCII logo and separators
│   ├── colors.py              # Terminal color definitions
│   ├── completer.py           # Tab completion handler
│   ├── desktop_entry.py       # .desktop file creator
│   └── file_manager.py        # Core file management logic
├── data/
│   ├── icons/
│   │   └── icon.png           # Application icon
│   └── images/
│       └── main_menu.png      # Menu screenshot
├── .gitignore
├── LICENSE
└── README.md

• Pure Python 3 — Uses only standard library (no external dependencies)
• Tab Completion — Powered by Python's readline module with custom path completer
• Recursive Scanning — Efficient directory walking with real-time progress
• Hex Viewer — Binary-safe reading with hexdump-style formatting
• MD5 Calculation — Streaming hash computation for files of any size
• Desktop Integration — Generates freedesktop.org-compatible .desktop files
• Paging Support — Uses less/more for long output, falls back to inline display

• Deletion is permanent — No recycle bin, files are removed immediately
• All operations require confirmation — Especially destructive actions
• No data collection — Works completely offline, no telemetry
• Respects permissions — Cannot access files without proper OS permissions
• Desktop files are safe — Created in user directories, not system-wide

• Tab completion not working?
  Install readline: pip3 install readline
• "less" pager not found?
  Install less: sudo apt install less (Debian/Ubuntu) or sudo pacman -S less (Arch)
• Desktop entries not showing?
  Update desktop database: update-desktop-database ~/.local/share/applications/
• Permission denied errors?
  Run with appropriate user permissions, check file ownership with ls -la /path/to/file

• Language: Python 3
• Platform: Linux (cross-platform ready)
• Dependencies: None (standard library only)
• License: BSD 3-Clause

By using this software, you agree to the full disclaimer terms.

Software provided "AS IS" without warranty. You assume all risks for file operations, deletions, and system interactions.

Full legal disclaimer: DISCLAIMER.md