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.1.tar.gz (41.6 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.1-py3-none-any.whl (42.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: meine-1.0.1.tar.gz
  • Upload date:
  • Size: 41.6 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.1.tar.gz
Algorithm Hash digest
SHA256 44a9e1dd6653e3bc33fb5173c41f3ab996a524a0147613e8b5dec7cbfdd113fd
MD5 6f063c2ea7c3f5249952e38d53087309
BLAKE2b-256 c81108f99027e39d147895651d67704eab49cc71eb410163a090f43691989919

See more details on using hashes here.

File details

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

File metadata

  • Download URL: meine-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 42.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6f4094fe6085eb6fa57d12226f201be8175cd6286d5e592b39468955d8f5452a
MD5 430941150a3898040f9b9d62a6b22f29
BLAKE2b-256 3e1ae4c4d3fc8b00e2f9f32c60cc04cc5d07bf339dcebb3a0f7e6b44276a7b82

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