🕰️ MineClock_LightCycle — Minecraft-style Clock Plasmoid (Plasma 6)

Package ID: org.kde.mineclock_lightcycle

Small, lightweight widget showing a Minecraft-like day/night clock using a 64-frame PNG sequence. Features local solar tracking (sunrise/sunset) and customizable digital time overlay.

must put in general location or it will show a crazy random sunrise time

---

🧩 What it does

• 64-frame animation mimicking Minecraft's clock cycle.
• Solar Tracking: Option to map the clock to local sunrise/sunset based on coordinates.
• System Time: Option to use standard 24-hour rotation.
• Digital Overlay: Toggleable time readout in Minecraft font.
• Customizable Padding: Adjust the clock image size within the widget.

---

📂 Layout

org.kde.mineclock_lightcycle/
├── contents
│   ├── config
│   │   ├── config.qml
│   │   └── main.xml        (settings definitions)
│   ├── ui
│   │   ├── main.qml        (UI + logic)
│   │   ├── ConfigGeneral.qml (Settings UI)
│   │   ├── SunCalc.js      (Solar calculations)
│   │   └── clock/          (Frame assets)
│   └── fonts
│       └── Monocraft.ttf
├── metadata.json
├── preview.png
└── README.md

---

⚙️ Quick install (user-local)

Recommended for testing:

mkdir -p ~/.local/share/plasma/plasmoids/
cp -r org.kde.mineclock_lightcycle ~/.local/share/plasma/plasmoids/

Then restart Plasma or run:

plasmoidviewer ~/.local/share/plasma/plasmoids/org.kde.mineclock_lightcycle/contents/ui/main.qml

---

🎮 Usage

• Add via Desktop → Add Widgets → MineClock_LightCycle
• Solar Mode: Enter your latitude/longitude in settings for accurate day/night scaling.
• System Mode: Follows the system clock (noon at frame 0).
• Interactions: Click or hover to see sunrise/sunset times.

---

⚙️ Settings

Right-click → Configure MineClock_LightCycle...

Key options

• Time Source: Toggle between System Time and Solar Tracking.
• Coordinates: Latitude/Longitude for solar calculations.
• Offset: Manual minute offset for fine-tuning.
• Digital Time: Show/hide the digital readout.
• 24-hour format: Toggle between 24h and AM/PM.
• Image Padding: Adjust (0–50%) to change the clock's visual size.

---

Helpfull commands for my notes

kquitapp6 plasmashell kstart plasmashell

---

📜 License

GNU General Public License v3.0 or later

See LICENSE for full text.

---

🙏 Credits

• Built for KDE Plasma 6. Inspired by the Minecraft clock/compass.
• Built over: https://github.com/calamytryx/MineClock