Skip to main content

⚡MeineRe - A regex-powered, asynchronous CLI file manager and system utility built with Textual. It combines intuitive command parsing with rich terminal UI, allowing you to navigate directories, manage files, and fetch system info—fast.

Project description

meine

project-banner

⚙️ meine is a cross-platform, regex-powered command-line interface for automating file operations, system control, and archive manipulation—delivered in a beautiful terminal UI. Modular, asynchronous, and extensible. Built for those who want raw power in a refined shell.


🚀 Features

  • 🔍 Regex-Based Command Parsing Use intuitive commands to delete, copy, move, rename, search, and create files or folders.

  • 🗂️ TUI Directory Navigator Browse your filesystem in a reactive terminal UI—keyboard and mouse supported.

  • 💬 Live Command Console A built-in shell for interpreting commands and reflecting state changes in real time.

  • ⚡ Asynchronous & Modular Built with asyncio, aiofiles, py7zr, and modular architecture for responsive performance.

  • 🎨 Theming & Config CSS-powered themes, JSON-based user preferences, and dynamic runtime settings.

  • 📊 System Dashboard Real-time system insights via one-liner commands: cpu, ram, gpu, battery, ip, user, env, and more.

  • 🧩 Plugin Ready Drop in your own Python modules to extend functionality without altering core logic.


📸 Screenshots

Opening screen Input shell Text editor Settings screen


🛠️ Installation

Install via pip

Requires Python 3.10+

pip install meine

Or clone the repo:

git clone https://github.com/Balaji01-4D/meine
cd meine
pip install .

🔤 Regex-Based Commands

Action Syntax Example
Delete del file.txt · rm file1.txt, file2.txt
Copy copy a.txt to b.txt · cp a1.txt, a2.txt to d/
Move move a.txt to d/ · mv f1.txt, f2.txt to ../
Rename rename old.txt as new.txt
Create mk file.txt · mkdir folder1, folder2
Search search "text" folder/ · find "term" notes.md

🧱 Project Structure

meine/
├── meine/              # Core package
│   ├── app.py          # Main entry point
│   ├── themes.py       # Theme loader
│   ├── runtime_config.json
│   ├── tcss/           # Terminal CSS files
│   ├── resources/      # JSON static data
│   ├── widgets/        # UI components
│   ├── screens/        # Screen layouts (text editor, dashboard, etc.)
│   ├── Actions/        # File and system command handlers
│   └── utils/          # Helper functions
├── pyproject.toml      # PEP-517/518 build config
├── README.md
├── requirements.txt
└── LICENSE

✨ Roadmap

  • Plugin Manager System
  • Git & GitHub integration
  • Built-in Task Scheduler
  • Voice Command Support
  • Remote SSH Execution

🙌 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

To contribute:

git clone https://github.com/Balaji01-4D/meine
cd meine
python -m venv .venv
source .venv/bin/activate
pip install -e .

📄 License

Licensed under the MIT License.


💬 Connect

Got feedback, suggestions, or just wanna say hi?


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meine-1.0.0.tar.gz (41.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meine-1.0.0-py3-none-any.whl (41.8 kB view details)

Uploaded Python 3

File details

Details for the file meine-1.0.0.tar.gz.

File metadata

  • Download URL: meine-1.0.0.tar.gz
  • Upload date:
  • Size: 41.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for meine-1.0.0.tar.gz
Algorithm Hash digest
SHA256 c9042455bb235006e0d2a036353343518a3d09322c566945ce9014ddb66a6d85
MD5 26c679858e28c522b85965d8f701eccb
BLAKE2b-256 5ac98bfc39dd401a16d0b179f14347557b37abb4095e47c51c93ed6d7513c808

See more details on using hashes here.

File details

Details for the file meine-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: meine-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 41.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for meine-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4814a8ea6e9438b4f473394fa82a44e33842f03e20375f1b6866dac92c1dd82f
MD5 6eb40f2a451ece1e086d00312d23202e
BLAKE2b-256 13cb1fa1a22317d442d2cfe00f8a90a2015b37b3fbe15484f340856099c5207b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page