swadhin / laxyfile public
/ laxyfile / README.md
swadhin biswas Update on working process · 7/28/2025
f1cf876
379 lines · 10.1 KB
Raw Download

🚀 LaxyFile - Advanced Terminal File Manager

Tests
codecov
PyPI version
Python 3.8+
License: MIT

A beautiful, AI-powered terminal file manager inspired by Superfile with advanced media support and intelligent automation

✨ Features

🎨 Beautiful Interface

  • 5 Gorgeous Themes: Cappuccino (default), Neon, Ocean, Sunset, Forest
  • Modern UI: Rounded borders, colorful file listings, beautiful header with rainbow gradient
  • Smart Icons: File type icons for 50+ formats with Unicode support
  • Dual-Pane: Side-by-side directory browsing with preview panel
  • Responsive: Adapts to terminal size with optimal layout

🤖 AI Assistant (Powered by Kimi AI)

  • Complete System Analysis: Monitor devices, processes, storage, and network
  • Intelligent File Organization: AI suggests optimal directory structures and file management
  • Security Audits: Vulnerability detection, permission analysis, suspicious file identification
  • Performance Optimization: Storage cleanup, resource monitoring, speed improvements
  • Video & Media Analysis: Metadata extraction, encoding details, organization suggestions
  • Duplicate Detection: Smart file comparison and cleanup recommendations
  • Content Analysis: Read and understand file contents for better suggestions
  • Real-time Insights: Instant analysis and actionable recommendations

📁 Advanced File Management

  • Smart Operations: Copy, move, delete, rename with progress feedback
  • Multi-Selection: Select multiple files with visual indicators
  • Quick Navigation: Vim-style (hjkl) + arrow keys, instant directory jumping
  • Hidden Files: Toggle visibility with smart filtering
  • File Operations: Create directories, batch operations, trash support

🎬 Media & Content Viewing

  • Image Support: ASCII art conversion with color preservation, metadata display
  • Video Analysis: Thumbnail generation, metadata extraction, format details
  • Code Highlighting: Syntax highlighting for 100+ programming languages
  • Preview Panel: Real-time file preview with smart content detection
  • Terminal Graphics: Sixel, Kitty, iTerm2 support for high-quality images

⚡ Performance & Usability

  • Fast Navigation: Instant directory switching, efficient file loading
  • Session Memory: Remember last directories and settings
  • Configurable: YAML configuration with extensive customization
  • Error Handling: Graceful failure recovery, comprehensive logging
  • Cross-Platform: Linux, macOS, Windows support

🛠️ Installation

Quick Install

# Clone the repository
git clone https://github.com/yourusername/laxyfile.git
cd laxyfile

# Install dependencies
pip install -r requirements.txt

# Run LaxyFile
python run_laxyfile.py

Dependencies

# Core dependencies (required)
pip install rich pydantic PyYAML Pillow opencv-python pygments

# AI features (recommended)
pip install openai psutil python-magic requests aiofiles

🤖 AI Setup (Free!)

1. Get OpenRouter API Key

  1. Visit https://openrouter.ai/
  2. Create a free account
  3. Get your API key (free tier includes Kimi AI model)

2. Configure Environment

# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export OPENROUTER_API_KEY="your-api-key-here"

# Reload your shell
source ~/.bashrc

3. Verify AI Setup

# Launch LaxyFile
python run_laxyfile.py

# Look for: "🤖 AI Assistant: Ready with Kimi AI model"

🎯 Usage

Basic Navigation

  • hjkl or Arrow Keys: Navigate files
  • Tab: Switch between panels
  • Enter: Open file/directory
  • Space: Select/deselect files
  • g/G: Jump to top/bottom

File Operations

  • c: Copy selected files
  • m: Move selected files
  • d: Delete files
  • r: Rename file
  • n: New directory
  • v: View file with media viewer
  • e: Edit file

🤖 AI Features

  • i: Open AI Assistant menu
  • F9: Quick AI analysis of current directory

AI Assistant Menu Options:

  1. 💬 Chat: Ask AI anything about your files
  2. 🔍 System Analysis: Complete device and file analysis
  3. 📁 File Organization: Smart organization suggestions
  4. 🔒 Security Audit: Vulnerability and security analysis
  5. ⚡ Performance: Optimization recommendations
  6. 🎬 Video Analysis: Media file analysis and optimization
  7. 🔄 Duplicates: Find and manage duplicate files
  8. 📸 Media Organization: Organize photos and videos intelligently
  9. 💾 Backup Strategy: Intelligent backup recommendations

Themes & UI

  • t: Cycle through themes
  • F1-F5: Set specific theme (Cappuccino, Neon, Ocean, Sunset, Forest)
  • p: Toggle preview panel
  • .: Toggle hidden files

Quick Navigation

  • ~: Go to home directory
  • /: Go to root directory
  • ?: Show help

🎨 Themes

🟤 Cappuccino (Default)

Warm browns and golden colors for a cozy coding experience

🌈 Neon

Bright electric colors with high contrast

🌊 Ocean

Cool blues and teals for a calming experience

🌅 Sunset

Warm oranges and reds for vibrant browsing

🌲 Forest

Natural greens and earth tones

🔧 Configuration

Create ~/.config/laxyfile/config.yaml:

# AI Configuration
ai:
  enabled: true
  provider: "openrouter"
  model: "moonshotai/kimi-dev-72b:free"
  max_tokens: 4000
  enable_content_analysis: true
  enable_device_monitoring: true

# Theme and UI
theme:
  name: "cappuccino"
  use_icons: true

ui:
  preview_pane: true
  refresh_rate: 30

# Keyboard shortcuts
hotkeys:
  ai_assistant: ["i"]
  quick_ai_analysis: ["F9"]

See example_config.yaml for complete configuration options.

🚀 AI Examples

System Analysis

🤖 AI analyzing your system...

📊 SYSTEM OVERVIEW:
• CPU: Intel i7 (8 cores) - 15% usage
• Memory: 16GB (45% used)
• Storage: 512GB SSD (78% full)
• Network: Connected, 50+ Mbps

📁 DIRECTORY ANALYSIS:
• 1,247 files across 89 directories
• Top types: .js (234), .py (156), .jpg (89)
• Large files: video.mp4 (2.1GB), dataset.csv (456MB)

🔍 RECOMMENDATIONS:
• Clean up old videos to free 3.2GB space
• Archive old project files to external storage
• Consider organizing code files by project
• Update system packages for security

Smart File Organization

🤖 Analyzing file structure...

📂 CURRENT STRUCTURE:
Downloads/
├── 234 mixed files (docs, images, code)
├── No clear organization pattern
└── 15 duplicate files detected

✨ RECOMMENDED STRUCTURE:
Downloads/
├── Documents/
│   ├── PDFs/
│   └── Spreadsheets/
├── Media/
│   ├── Images/2024/
│   └── Videos/
├── Code/
│   ├── Python/
│   └── JavaScript/
└── Archive/old_files/

🎯 ACTIONS:
1. Move 89 images to Media/Images/2024/
2. Organize 45 documents by type
3. Remove 15 duplicate files (saves 234MB)
4. Archive files older than 1 year

Security Audit

🔒 SECURITY ANALYSIS:

⚠️  VULNERABILITIES FOUND:
• 3 executable files with 777 permissions
• 12 hidden files in system directories
• 1 suspicious .exe file detected
• Weak permissions on SSH keys

🛡️  RECOMMENDATIONS:
• Fix file permissions: chmod 644 suspicious_files
• Review hidden files for malware
• Move executables to secure location
• Strengthen SSH key permissions (600)
• Enable firewall for additional protection

🔍 MONITORING:
• No active suspicious processes
• Network connections appear normal
• File integrity checks passed

🎬 Video Features

LaxyFile includes advanced video analysis capabilities:

  • Format Detection: Automatically identify video codecs and containers
  • Metadata Extraction: Resolution, framerate, duration, bitrate
  • Thumbnail Generation: Preview frames for quick identification
  • Quality Analysis: Bitrate analysis and compression recommendations
  • Organization: Smart sorting by resolution, date, or quality
  • Conversion Suggestions: AI recommends optimal formats for different uses

📋 System Requirements

  • Python: 3.8 or higher
  • Terminal: Any modern terminal with color support
  • OS: Linux, macOS, Windows (with proper terminal)
  • Memory: 256MB+ RAM
  • Storage: 50MB+ free space

Recommended

  • Terminal: Kitty, iTerm2, or modern terminal with truecolor support
  • Size: 120x30 characters or larger
  • Fonts: Nerd Fonts or Unicode-compatible monospace font

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

git clone https://github.com/yourusername/laxyfile.git
cd laxyfile
pip install -r requirements.txt
python run_laxyfile.py

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

  • Superfile: Inspiration for the beautiful terminal interface
  • Rich: Amazing terminal rendering library
  • OpenRouter: AI API platform providing access to Kimi AI
  • Kimi AI: Powerful language model for intelligent file analysis

🆘 Troubleshooting

AI Not Working?

# Check API key
echo $OPENROUTER_API_KEY

# Verify dependencies
pip install openai psutil python-magic

# Test connection
python -c "import openai; print('OpenAI client available')"

Display Issues?

# Set terminal variables
export TERM="xterm-256color"
export COLORTERM="truecolor"

# Resize terminal to 120x30 or larger

Permission Errors?

# Check file permissions
ls -la laxyfile/

# Fix if needed
chmod +x run_laxyfile.py

Experience the future of terminal file management! 🚀