Skip to content

Cyangata/Miaustics

Repository files navigation

# Miaustics ✿

Welcome to **Miaustics**, your modular, multilingual system diagnostics & tools suite — a cozy 🐾 and flexible way to explore and manage your system directly from the console! (✿◡‿◡)

---

## What is Miaustics? (❁´◡`❁)

Miaustics is a console-based, multi-language software designed to help you run diagnostic tools and scripts on your system. The charm? It’s modular! You can add your own tools by simply dropping Python `.py` files into the `miaustics/tools/` folder. Miaustics will discover these tools dynamically and show them in the menu for you to run — easy, elegant, and pinkish ✿.

It supports multiple languages out of the box, using JSON translation files, so it speaks your language, and if not, you can add a translation easly into the `translations/tools/` folder.

---

## Features (●'◡'●)ᓚᘏᗢ

- 🌸 Modular tools system — add & run your own Python tools.
- 🌸 Multilanguage UI (English, Spanish, and others via JSON).
- 🌸 Intuitive console interface with cute pink-style highlights & flower selection arrows (✿).
- 🌸 System actions placeholders: shutdown, restart, hibernate (safe by default).
- 🌸 Language selector to switch languages on the fly.
- 🌸 Tool selector menu integrated for neat organization.

---

## ROADMAP (*/ω\*)

1. **Add more basic diagnostic tools:** We want to grow Miaustics with handy system checks and utilities.
2. **Build as a standalone `.exe` file:** No need for `.bat`, just double-click and go!
3. **Linux installation support:** Install Miaustics system-wide and run it by typing `miaustics` from any terminal.
4. **Command-line arguments:** Enable launching with specific options or running tools directly from the command line.

---

## How to Use (❀◦‿◦)

1. Clone or download the repository.
2. Add your own Python tools inside the `miaustics/tools/` folder.
3. Run Miaustics using:

Windows: miaustics/Execute.bat

Linux: miaustics/Linux_execute.sh


---

## Contributing 🌷

Feel free to add your own tools or translations! Just drop new `.py` files in `tools/` or JSON files under `translations/` following the current format.

---

## Thank you for trying Miaustics! ✿(❁´◡`❁)

I hope it adds a little pink magic to your system maintenance! (●'◡'●)

ᓚᘏᗢ

Releases

No releases published

Packages

No packages published

Languages