Metadata-Version: 2.4
Name: meine
Version: 1.0.1
Summary: ⚡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.
Author-email: balaji j <j.balaji2468@gmail.com>
License: MIT License
        
        Copyright (c) 2024 BALAJI.J
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiofiles==24.1.0
Requires-Dist: appdirs==1.4.4
Requires-Dist: Brotli==1.1.0
Requires-Dist: click==8.2.1
Requires-Dist: inflate64==1.0.1
Requires-Dist: linkify-it-py==2.0.3
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: mdit-py-plugins==0.4.2
Requires-Dist: mdurl==0.1.2
Requires-Dist: multivolumefile==0.2.3
Requires-Dist: platformdirs==4.3.8
Requires-Dist: psutil==7.0.0
Requires-Dist: py7zr==0.22.0
Requires-Dist: pybcj==1.0.6
Requires-Dist: pycryptodomex==3.23.0
Requires-Dist: Pygments==2.19.1
Requires-Dist: pyppmd==1.1.1
Requires-Dist: pyzstd==0.17.0
Requires-Dist: rich==14.0.0
Requires-Dist: texttable==1.7.0
Requires-Dist: textual==3.2.0
Requires-Dist: typing_extensions==4.13.2
Requires-Dist: uc-micro-py==1.0.3
Requires-Dist: xdialog==1.2.0.1
Dynamic: license-file


# meine

<p align="center">
  <img src="https://socialify.git.ci/Balaji01-4D/meine/image?description=1&font=Jost&language=1&name=1&owner=1&pattern=Floating+Cogs&theme=Auto" alt="project-banner">
</p>

> ⚙️ **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

<p float="left">
  <img src="https://github.com/Balaji01-4D/meine/blob/main/img/opening.png" width="100%" alt="Opening screen">
  <img src="https://github.com/Balaji01-4D/meine/blob/main/img/input.png" width="100%" alt="Input shell">
  <img src="https://github.com/Balaji01-4D/meine/blob/main/img/texteditor.png" width="100%" alt="Text editor">
  <img src="https://github.com/Balaji01-4D/meine/blob/main/img/settings.png" width="100%" alt="Settings screen">
</p>

---

## 🛠️ Installation

**Install via pip**
> Requires Python 3.10+

```bash
pip install meine
```

Or clone the repo:

```bash
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

```text
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:

```bash
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](LICENSE).

---

## 💬 Connect

Got feedback, suggestions, or just wanna say hi?

- Instagram: [__balaji.j__](https://www.instagram.com/__balaji.j__/)
- GitHub Issues: [meine Issues](https://github.com/Balaji01-4D/meine/issues)

---
