m5-mikufetch 0.2.0__tar.gz

m5_mikufetch-0.2.0/.github/workflows/python-publish.yml

@@ -0,0 +1,50 @@
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

m5_mikufetch-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release m5-mikufetch
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-all:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build tar.gz + whl
+        run: |
+          pip install build
+          python -m build
+
+      - name: Install nfpm
+        run: |
+          echo 'deb [trusted=yes] https://repo.goreleaser.com/apt/ /' | sudo tee /etc/apt/sources.list.d/goreleaser.list
+          sudo apt-get update
+          sudo apt-get install nfpm
+
+      - name: Build .deb and .rpm
+        run: |
+          nfpm pkg --packager deb --target dist/
+          nfpm pkg --packager rpm --target dist/
+
+      - name: Build Windows zip
+        run: |
+          echo "@echo off" > run_mikufetch.bat
+          echo "python mikufetch/main.py %*" >> run_mikufetch.bat
+          echo "pause" >> run_mikufetch.bat
+          zip -r dist/mikufetch-windows.zip mikufetch/ run_mikufetch.bat pyproject.toml README.md
+
+      - name: Upload Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: "m5-mikufetch ${{ github.ref_name }}"
+          body: |
+            ## 🎵 m5-mikufetch ${{ github.ref_name }}
+            
+            ### Install
+            ```bash
+            pip install m5-mikufetch
+             ```
+            
+            ### Packages
+            | File | Platform |
+            |------|----------|
+            | `.whl` | pip / PyPI |
+            | `.tar.gz` | source |
+            | `.deb` | Ubuntu / Debian |
+            | `.rpm` | Fedora / RHEL |
+            | `.zip` | Windows |
+          files: |
+            dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

m5_mikufetch-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M5 Dev
+
+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.

m5_mikufetch-0.2.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: m5-mikufetch
+Version: 0.2.0
+Summary: A Hatsune Miku & Kasane Teto themed system fetch tool for the terminal
+Author-email: M5 Dev <claus.valca67@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,fetch,miku,neofetch,system-info,teto,utau,vocaloid
+Requires-Python: >=3.11
+Requires-Dist: psutil>=5.9
+Description-Content-Type: text/markdown
+
+# mikufetch 🎵
+
+A Hatsune Miku & Kasane Teto themed system fetch tool for the terminal, written in Python.
+
+If you are looking for a Neofetch alternative that brings your favorite Vocaloid to your terminal, **mikufetch** is the perfect choice for your Linux rice 🌸
+
+```
+   ||       ||     runner@hostname
+   ||       ||     ─────────────────
+  (  \_____/  )    OS        Ubuntu 24.04.2 LTS
+  |  (^   ^)  |    Kernel    6.14.11
+  |     u     |    CPU       AMD EPYC 9B14
+  |  ~-----~  |    RAM       4.20GB / 15.6GB
+  |   [===]   |    Shell     bash
+   \   | |   /     Terminal  xterm-256color
+    \  | |  /      Uptime    2d 4h 30m
+   /\  | |  /\     Packages  512 (apt)
+  /  \_|_|_/  \
+ /   MIKU  39  \
+```
+
+![Python](https://img.shields.io/badge/python-3.11+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Stars](https://img.shields.io/github/stars/M5Develop/mikufetch?style=social)
+![PyPI](https://img.shields.io/pypi/v/m5-mikufetch)
+
+---
+
+## Features
+
+- **Hatsune Miku** ASCII art rendered in **CYAN** 💙
+- **Kasane Teto** ASCII art rendered in **RED** ❤️
+- **Random mode** — let fate decide your character
+- **OS & Kernel** — reads from `/etc/os-release` and `platform.release()`
+- **CPU** — fast direct read from `/proc/cpuinfo`, falls back to `platform.processor()`
+- **RAM** — used / total via `psutil`
+- **Shell** — bulletproof detection: checks `$SHELL`, then `/proc/self/exe`, then parent PID
+- **Terminal** — reads `$TERM_PROGRAM`, `$COLORTERM`, and `$TERM`
+- **Uptime** — calculated from `psutil.boot_time()`, displayed as `Xd Xh Xm`
+- **Package count** — supports `apt`, `pacman`, `dnf`, and `apk`
+
+---
+
+## Installation
+
+```bash
+pip install m5-mikufetch
+```
+
+Then run from anywhere:
+
+```bash
+mikufetch
+```
+
+---
+
+## Usage
+
+```bash
+# Default — Hatsune Miku 💙
+mikufetch
+
+# Kasane Teto mode 🔴
+mikufetch --teto
+mikufetch -t
+
+# Pick manually
+mikufetch --art miku
+mikufetch --art teto
+
+# Random character
+mikufetch --random
+mikufetch -r
+```
+
+---
+
+## Requirements
+
+- Python 3.11+
+- `psutil >= 5.9`
+- Linux (macOS/Windows partial support)
+
+---
+
+## Project structure
+
+```
+mikufetch/
+├── mikufetch/
+│   ├── __init__.py
+│   ├── main.py        # System info logic, CLI, and rendering
+│   └── ascii_art.py   # Miku & Teto ASCII art
+├── pyproject.toml
+├── nfpm.yaml
+└── README.md
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/M5Develop/mikufetch
+cd mikufetch
+pip install -e .
+mikufetch --teto
+```
+
+---
+
+## License
+
+MIT — made with 💙❤️ by [M5Dev](https://github.com/M5Develop)
+
+Miku & Teto ASCII art are fan-made. Not affiliated with Crypton Future Media or TWINDRILL.

m5_mikufetch-0.2.0/README.md

@@ -0,0 +1,117 @@
+# mikufetch 🎵
+
+A Hatsune Miku & Kasane Teto themed system fetch tool for the terminal, written in Python.
+
+If you are looking for a Neofetch alternative that brings your favorite Vocaloid to your terminal, **mikufetch** is the perfect choice for your Linux rice 🌸
+
+```
+   ||       ||     runner@hostname
+   ||       ||     ─────────────────
+  (  \_____/  )    OS        Ubuntu 24.04.2 LTS
+  |  (^   ^)  |    Kernel    6.14.11
+  |     u     |    CPU       AMD EPYC 9B14
+  |  ~-----~  |    RAM       4.20GB / 15.6GB
+  |   [===]   |    Shell     bash
+   \   | |   /     Terminal  xterm-256color
+    \  | |  /      Uptime    2d 4h 30m
+   /\  | |  /\     Packages  512 (apt)
+  /  \_|_|_/  \
+ /   MIKU  39  \
+```
+
+![Python](https://img.shields.io/badge/python-3.11+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Stars](https://img.shields.io/github/stars/M5Develop/mikufetch?style=social)
+![PyPI](https://img.shields.io/pypi/v/m5-mikufetch)
+
+---
+
+## Features
+
+- **Hatsune Miku** ASCII art rendered in **CYAN** 💙
+- **Kasane Teto** ASCII art rendered in **RED** ❤️
+- **Random mode** — let fate decide your character
+- **OS & Kernel** — reads from `/etc/os-release` and `platform.release()`
+- **CPU** — fast direct read from `/proc/cpuinfo`, falls back to `platform.processor()`
+- **RAM** — used / total via `psutil`
+- **Shell** — bulletproof detection: checks `$SHELL`, then `/proc/self/exe`, then parent PID
+- **Terminal** — reads `$TERM_PROGRAM`, `$COLORTERM`, and `$TERM`
+- **Uptime** — calculated from `psutil.boot_time()`, displayed as `Xd Xh Xm`
+- **Package count** — supports `apt`, `pacman`, `dnf`, and `apk`
+
+---
+
+## Installation
+
+```bash
+pip install m5-mikufetch
+```
+
+Then run from anywhere:
+
+```bash
+mikufetch
+```
+
+---
+
+## Usage
+
+```bash
+# Default — Hatsune Miku 💙
+mikufetch
+
+# Kasane Teto mode 🔴
+mikufetch --teto
+mikufetch -t
+
+# Pick manually
+mikufetch --art miku
+mikufetch --art teto
+
+# Random character
+mikufetch --random
+mikufetch -r
+```
+
+---
+
+## Requirements
+
+- Python 3.11+
+- `psutil >= 5.9`
+- Linux (macOS/Windows partial support)
+
+---
+
+## Project structure
+
+```
+mikufetch/
+├── mikufetch/
+│   ├── __init__.py
+│   ├── main.py        # System info logic, CLI, and rendering
+│   └── ascii_art.py   # Miku & Teto ASCII art
+├── pyproject.toml
+├── nfpm.yaml
+└── README.md
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/M5Develop/mikufetch
+cd mikufetch
+pip install -e .
+mikufetch --teto
+```
+
+---
+
+## License
+
+MIT — made with 💙❤️ by [M5Dev](https://github.com/M5Develop)
+
+Miku & Teto ASCII art are fan-made. Not affiliated with Crypton Future Media or TWINDRILL.

m5_mikufetch-0.2.0/mikufetch/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

m5_mikufetch-0.2.0/mikufetch/ascii_art.py

@@ -0,0 +1,42 @@
+CYAN  = "\033[96m"
+RED   = "\033[91m"
+WHITE = "\033[97m"
+RESET = "\033[0m"
+
+MIKU_LINES = [
+    r"   ||       ||   ",
+    r"   ||       ||   ",
+    r"  (  \_____/  )  ",
+    r"  |  (^   ^)  |  ",
+    r"  |     u     |  ",
+    r"  |  ~-----~  |  ",
+    r"  |   [===]   |  ",
+    r"   \   | |   /   ",
+    r"    \  | |  /    ",
+    r"   /\  | |  /\   ",
+    r"  /  \_|_|_/  \  ",
+    r" /   MIKU  39  \  ",
+]
+
+TETO_LINES = [
+    r"   /\       /\  ",
+    r"  /  \_____/  \ ",
+    r" | drill  hair | ",
+    r"  \  (>w<)  /  ",
+    r"   |  ___  |   ",
+    r"   | [===] |   ",
+    r"   |  | |  |   ",
+    r"    \ | | /    ",
+    r"   /\| | |/\   ",
+    r"  /  \| |/  \  ",
+    r" / KASANE TETO \ ",
+    r"/   UTAU  100  \ ",
+]
+
+MIKU_ART = [f"{CYAN}{line}{RESET}" for line in MIKU_LINES]
+TETO_ART = [f"{RED}{line}{RESET}"  for line in TETO_LINES]
+
+ARTS = {
+    "miku": MIKU_ART,
+    "teto": TETO_ART,
+}

m5_mikufetch-0.2.0/mikufetch/main.py

@@ -0,0 +1,194 @@
+import psutil
+import platform
+import os
+import time
+import getpass
+import subprocess
+import argparse
+import random
+
+from mikufetch.ascii_art import MIKU_ART, TETO_ART, ARTS, CYAN, RED, WHITE, RESET
+
+BOLD = "\033[1m"
+DIM  = "\033[2m"
+
+
+def get_distro() -> str:
+    if platform.system() == "Linux":
+        try:
+            with open("/etc/os-release") as f:
+                for line in f:
+                    if line.startswith("PRETTY_NAME"):
+                        return line.split("=", 1)[1].strip().strip('"')
+        except Exception:
+            pass
+    return platform.system()
+
+
+def get_cpu_info() -> str:
+    if platform.system() == "Linux":
+        try:
+            with open("/proc/cpuinfo") as f:
+                for line in f:
+                    if line.startswith("model name"):
+                        return line.split(":", 1)[1].strip()
+        except Exception:
+            pass
+    return platform.processor() or "Unknown CPU"
+
+
+def get_shell() -> str:
+    shell_env = os.environ.get("SHELL", "")
+    if shell_env:
+        name = shell_env.split("/")[-1]
+        if name not in ("sh", ""):
+            return name
+    skip = {"sh", "python", "python3", "python3.11", "python3.12", ""}
+    pid = os.getppid()
+    for _ in range(5):
+        try:
+            resolved = os.readlink(f"/proc/{pid}/exe")
+            name = resolved.split("/")[-1]
+            if name not in skip:
+                return name
+            with open(f"/proc/{pid}/status") as f:
+                for line in f:
+                    if line.startswith("PPid:"):
+                        pid = int(line.split()[1])
+                        break
+        except Exception:
+            break
+    return shell_env.split("/")[-1] if shell_env else "sh"
+
+
+def get_terminal() -> str:
+    for var in ("TERM_PROGRAM", "TERMINAL", "COLORTERM", "TERM"):
+        val = os.environ.get(var, "")
+        if val:
+            return val
+    return "unknown"
+
+
+def get_uptime() -> str:
+    seconds = int(time.time() - psutil.boot_time())
+    days,    remainder = divmod(seconds, 86400)
+    hours,   remainder = divmod(remainder, 3600)
+    minutes, _         = divmod(remainder, 60)
+    parts = []
+    if days:
+        parts.append(f"{days}d")
+    if hours:
+        parts.append(f"{hours}h")
+    parts.append(f"{minutes}m")
+    return " ".join(parts)
+
+
+def get_packages() -> str:
+    managers = {
+        "apt":    ["dpkg-query", "-f", "${binary:Package}\n", "-W"],
+        "pacman": ["pacman", "-Qq"],
+        "dnf":    ["rpm", "-qa"],
+        "apk":    ["apk", "info"],
+    }
+    for mgr, cmd in managers.items():
+        try:
+            result = subprocess.run(
+                cmd,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.DEVNULL,
+                timeout=3,
+            )
+            count = len(result.stdout.decode(errors="ignore").strip().splitlines())
+            if count > 0:
+                return f"{count} ({mgr})"
+        except Exception:
+            continue
+    return "N/A"
+
+
+def get_sys_info() -> dict:
+    return {
+        "user":     getpass.getuser(),
+        "host":     platform.node(),
+        "os":       get_distro(),
+        "kernel":   platform.release().split("-")[0],
+        "cpu":      get_cpu_info(),
+        "ram": (
+            f"{round(psutil.virtual_memory().used  / 1024**3, 2)}GB"
+            f" / "
+            f"{round(psutil.virtual_memory().total / 1024**3, 2)}GB"
+        ),
+        "shell":    get_shell(),
+        "terminal": get_terminal(),
+        "uptime":   get_uptime(),
+        "packages": get_packages(),
+    }
+
+
+def build_info_lines(info: dict, color: str) -> list[str]:
+    label = lambda k: f"{color}{BOLD}{k}{RESET}{WHITE}"
+    sep   = f"{DIM}@{RESET}"
+    return [
+        f"{BOLD}{info['user']}{sep}{info['host']}{RESET}",
+        f"{DIM}{'─' * (len(info['user']) + len(info['host']) + 1)}{RESET}",
+        f"{label('OS')}        {info['os']}",
+        f"{label('Kernel')}    {info['kernel']}",
+        f"{label('CPU')}       {info['cpu']}",
+        f"{label('RAM')}       {info['ram']}",
+        f"{label('Shell')}     {info['shell']}",
+        f"{label('Terminal')}  {info['terminal']}",
+        f"{label('Uptime')}    {info['uptime']}",
+        f"{label('Packages')}  {info['packages']}",
+    ]
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="mikufetch",
+        description="🎵 System fetch tool — Miku & Teto edition"
+    )
+    parser.add_argument(
+        "--art", "-a",
+        choices=["miku", "teto"],
+        default=None,
+        help="Choose character: miku (default) or teto"
+    )
+    parser.add_argument(
+        "--teto", "-t",
+        action="store_true",
+        help="Kasane Teto mode 🔴"
+    )
+    parser.add_argument(
+        "--random", "-r",
+        action="store_true",
+        help="Random character"
+    )
+    args = parser.parse_args()
+
+    if args.random:
+        choice = random.choice(["miku", "teto"])
+    elif args.teto:
+        choice = "teto"
+    elif args.art:
+        choice = args.art
+    else:
+        choice = "miku"
+
+    art   = ARTS[choice]
+    color = RED if choice == "teto" else CYAN
+
+    info       = get_sys_info()
+    info_lines = build_info_lines(info, color)
+
+    rows       = max(len(art), len(info_lines))
+    art_lines  = art        + ["                   "] * (rows - len(art))
+    info_lines = info_lines + [""]                   * (rows - len(info_lines))
+
+    print()
+    for art_line, info_line in zip(art_lines, info_lines):
+        print(f"{art_line}  {info_line}{RESET}")
+    print()
+
+
+if __name__ == "__main__":
+    main()

m5_mikufetch-0.2.0/nfpm.yaml

@@ -0,0 +1,18 @@
+name: "m5-mikufetch"
+arch: "amd64"
+platform: "linux"
+version: "0.2.0"
+section: "utils"
+priority: "optional"
+maintainer: "Claus <claus.valca67@gmail.com>"
+description: "A stylish system fetch tool featuring Hatsune Miku & Kasane Teto."
+vendor: "M5Develop"
+homepage: "https://github.com/M5Develop/mikufetch"
+license: "MIT"
+
+contents:
+  - src: "mikufetch/main.py"
+    dst: "/usr/bin/m5-mikufetch"
+    type: "file"
+    file_info:
+      mode: 0755

m5_mikufetch-0.2.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "m5-mikufetch"
+version = "0.2.0"
+description = "A Hatsune Miku & Kasane Teto themed system fetch tool for the terminal"
+authors = [{ name = "M5 Dev", email = "claus.valca67@gmail.com" }]
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+keywords = ["fetch", "neofetch", "miku", "teto", "vocaloid", "utau", "system-info", "cli"]
+dependencies = [
+    "psutil>=5.9",
+]
+
+[project.scripts]
+mikufetch = "mikufetch.main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["mikufetch"]