Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .Jules/palette.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
## 2025-05-15 - [KibaTV Welcome Tool Implementation]
**Learning:** In KibaTV (Plasma Bigscreen), a welcome tool is essential for TV-based UX to guide users who might not have a traditional keyboard/mouse setup. Zenity provides a quick, functional way to create these menus, but they must be registered in both `/usr/share/applications` (for menu discovery) and `/etc/xdg/autostart` (for first-run UX). Additionally, QML in KDE expects `//` for comments; using `#` causes the splash screen to fail silently or show an error.
**Action:** Always ensure `.desktop` files are placed in both locations for system tools. Use standard Zenity dimensions (450x500) for consistency on TVs. Always use `//` for QML comments.
9 changes: 3 additions & 6 deletions .codespellignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,3 @@
vEw
Bu
bu
t-e-h
r-e-c-e-i-v-e
o-c-c-u-r-e-d
teh
recieve
occured
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# bug_report.md
# Bug Report

---

Expand All @@ -8,7 +8,7 @@ about: Create a report to help us improve
title: ""
labels: ""

## assignees: ""
## Assignees: ""

**Describe the bug**
A clear and concise description of what the bug is.
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# feature_request.md
# Feature Request

---

Expand All @@ -8,7 +8,7 @@ about: Suggest an idea for this project
title: ""
labels: ""

## assignees: ""
## Assignees: ""

**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/auto-welcome-new-contributor-kiba.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
name: Auto Welcome New Contributor

Check failure on line 1 in .github/workflows/auto-welcome-new-contributor-kiba.yml

View workflow job for this annotation

GitHub Actions / actionlint

[actionlint] .github/workflows/auto-welcome-new-contributor-kiba.yml#L1

"on" section is missing in workflow [syntax-check]
Raw output
e:.github/workflows/auto-welcome-new-contributor-kiba.yml:1:1: "on" section is missing in workflow [syntax-check]
true:

Check failure on line 2 in .github/workflows/auto-welcome-new-contributor-kiba.yml

View workflow job for this annotation

GitHub Actions / actionlint

[actionlint] .github/workflows/auto-welcome-new-contributor-kiba.yml#L2

unexpected key "true" for "workflow" section. expected one of "concurrency", "defaults", "env", "jobs", "name", "on", "permissions", "run-name" [syntax-check]
Raw output
e:.github/workflows/auto-welcome-new-contributor-kiba.yml:2:1: unexpected key "true" for "workflow" section. expected one of "concurrency", "defaults", "env", "jobs", "name", "on", "permissions", "run-name" [syntax-check]
pull_request_target:
types:
- opened
Expand All @@ -24,6 +24,6 @@
script: "github.rest.issues.createComment({\n owner: context.repo.owner,\n\
\ repo: context.repo.repo,\n issue_number: context.issue.number,\n body:\
\ \"\U0001F680 Welcome to KibaTV! We're thrilled to see your first contribution.\
\ Please make sure you've read our [CONTRIBUTING.md](./CONTRIBUTING.md).\
\ Please make sure you've read our [../.../.../.../.../.../.../../CONTRIBUTING.md](../.../.../.../.../.../.../.../../CONTRIBUTING.md).\
\ \u2728\"\n})\n"
timeout-minutes: 5
8 changes: 4 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@
</p>

<p align="center">
<img src="https://img.shields.io/badge/Status-Welcome-success?style=for-the-badge" alt="Welcome">
<img src="https://img.shields.io/badge/License-MIT-purple?style=for-the-badge" alt="License">
<img src="[Link](https://img.shields.io/badge/Status-Welcome-success?style=for-the-badge") alt="Welcome">
<img src="[Link](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge") alt="License">
</p>

---
Expand All @@ -24,10 +24,10 @@ To begin contributing to the KibaTV build system or customization hooks, follow
3. **Local Build:** Run a local build to ensure your environment is working:

```bash
git clone [https://github.com/YOUR_USERNAME/Kiba](https://github.com/YOUR_USERNAME/Kiba)
git clone [[Link](https://github.com/YOUR_USERNAME/Kiba](https://github.com/YOUR_USERNAME/Kiba))
cd Kiba
docker run --rm --privileged -v "$PWD:/w" -e RUN_NUM=local debian:trixie /w/build.sh
```
```text

---

Expand Down
56 changes: 28 additions & 28 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
# KibaTV

<p align="center">
<img width="1983" height="793" alt="KibaTV Banner showing the Dracula-themed Plasma Bigscreen desktop environment" src="https://github.com/user-attachments/assets/1006d5ea-1e3c-4191-90de-72a79f4cb323" />
<img width="1983" height="793" alt="KibaTV Banner showing the Dracula-themed Plasma Bigscreen desktop environment" src="[Link](https://github.com/user-attachments/assets/1006d5ea-1e3c-4191-90de-72a79f4cb323") />

</p>

<p align="center">
<a href="https://github.com/WolfTech-Innovations/Kiba/actions/workflows/kiba.yml">
<img src="https://img.shields.io/github/actions/workflow/status/WolfTech-Innovations/Kiba/kiba.yml?branch=main&label=Build&style=for-the-badge" alt="Build Status">
<a href="[Link](https://github.com/WolfTech-Innovations/Kiba/actions/workflows/kiba.yml")>
<img src="[Link](https://img.shields.io/github/actions/workflow/status/WolfTech-Innovations/Kiba/kiba.yml?branch=main&label=Build&style=for-the-badge") alt="Build Status">
</a>
<img src="https://img.shields.io/badge/License-MIT-purple?style=for-the-badge" alt="License">
<img src="https://img.shields.io/badge/postmarketOS%20-D70A53?style=for-the-badge&logo=postmarketos&logoColor=green" alt="postmarketOS Version">
<img src="https://img.shields.io/badge/KDE-Plasma%206-22a7f0?style=for-the-badge&logo=kde&logoColor=white" alt="KDE Version">
<img src="[Link](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge") alt="License">
<img src="[Link](https://img.shields.io/badge/postmarketOS%20-D70A53?style=for-the-badge&logo=postmarketos&logoColor=green") alt="postmarketOS Version">
<img src="[Link](https://img.shields.io/badge/KDE-Plasma%206-22a7f0?style=for-the-badge&logo=kde&logoColor=white") alt="KDE Version">
</p>

<p align="center">
<img src="https://img.shields.io/github/repo-size/WolfTech-Innovations/Kiba?style=flat-square" alt="Repo Size">
<img src="https://img.shields.io/github/stars/WolfTech-Innovations/Kiba?style=flat-square" alt="Stars">
<img src="https://img.shields.io/github/forks/WolfTech-Innovations/Kiba?style=flat-square" alt="Forks">
<img src="https://img.shields.io/github/last-commit/WolfTech-Innovations/Kiba?style=flat-square" alt="Last Commit">
<img src="[Link](https://img.shields.io/github/repo-size/WolfTech-Innovations/Kiba?style=flat-square") alt="Repo Size">
<img src="[Link](https://img.shields.io/github/stars/WolfTech-Innovations/Kiba?style=flat-square") alt="Stars">
<img src="[Link](https://img.shields.io/github/forks/WolfTech-Innovations/Kiba?style=flat-square") alt="Forks">
<img src="[Link](https://img.shields.io/github/last-commit/WolfTech-Innovations/Kiba?style=flat-square") alt="Last Commit">
</p>

KibaTV is a lightweight Linux distribution built on **postmarketOS** with **Plasma Bigscreen** as the desktop environment. It is developed and maintained by **WolfTech Innovations**.

<p align="center">
<a href="https://sourceforge.net/projects/kibaos/files/latest/download">
<img src="https://a.fsdn.com/con/app/sf-download-button" alt="Download KibaTV">
<a href="[Link](https://sourceforge.net/projects/kibaos/files/latest/download")>
<img src="[Link](https://a.fsdn.com/con/app/sf-download-button") alt="Download KibaTV">
</a>
</p>

Expand Down Expand Up @@ -66,7 +66,7 @@ For a more in-depth look at KibaTV, check out our detailed documentation:

### Download

<img src="https://img.shields.io/sourceforge/dt/kibaos?style=flat-square" alt="SourceForge Downloads">
<img src="[Link](https://img.shields.io/sourceforge/dt/kibaos?style=flat-square") alt="SourceForge Downloads">

ISO images are available on **SourceForge**:
[Download KibaTV on SourceForge](https://sourceforge.net/projects/kibaos/files/)
Expand All @@ -79,7 +79,7 @@ On Linux:

```bash
sudo dd if=kibatv-vN.iso of=/dev/sdX bs=4M status=progress oflag=sync
```
```text

> [!IMPORTANT]
> Replace `/dev/sdX` with your actual drive and `N` with the build number. You can also use tools like **Balena Etcher** or **Ventoy**.
Expand Down Expand Up @@ -112,16 +112,16 @@ Post-install, update your system:

```bash
sudo apk update && sudo apk upgrade
```
```text

---

## Technical Details

### Shell

<img src="https://img.shields.io/badge/Shell-Zsh-blue?style=flat-square&logo=zsh&logoColor=white" alt="Shell: Zsh">
<img src="https://img.shields.io/badge/Kernel-CachyOS-orange?style=flat-square" alt="Kernel: CachyOS">
<img src="[Link](https://img.shields.io/badge/Shell-Zsh-blue?style=flat-square&logo=zsh&logoColor=white") alt="Shell: Zsh">
<img src="[Link](https://img.shields.io/badge/Kernel-CachyOS-orange?style=flat-square") alt="Kernel: CachyOS">

KibaTV uses **Zsh** by default with a pre-configured system-wide config at **`/etc/zsh/zshrc`**:

Expand All @@ -138,16 +138,16 @@ KibaTV uses **Zsh** by default with a pre-configured system-wide config at **`/e

### Theme

<img src="https://img.shields.io/badge/Theme-Dracula-bd93f9?style=flat-square&logo=dracula&logoColor=white" alt="Theme: Dracula">
<img src="[Link](https://img.shields.io/badge/Theme-Dracula-bd93f9?style=flat-square&logo=dracula&logoColor=white") alt="Theme: Dracula">

KibaTV ships the **Dracula** color scheme system-wide using the official palette

| Color | Hex | Role |
| ---------- | ------------- | ------------ |
| Background | `hex #282a36` | Primary BG |
| Purple | `hex #bd93f9` | Accent Color |
| Pink | `hex #ff79c6` | Selection |
| Green | `hex #50fa7b` | Success |
| Background | `hex &#35;282a36` | Primary BG |
| Purple | `hex &#35;bd93f9` | Accent Color |
| Pink | `hex &#35;ff79c6` | Selection |
| Green | `hex &#35;50fa7b` | Success |

The scheme is applied to **Plasma Bigscreen**, **Konsole**, **KWin** decorations, **Breeze Dark** panel, and **Plymouth**.

Expand All @@ -165,9 +165,9 @@ The scheme is applied to **Plasma Bigscreen**, **Konsole**, **KWin** decorations
## Build System

<p align="left">
<img src="https://img.shields.io/badge/Build-pmbootstrap-blue?style=flat-square" alt="Build: pmbootstrap">
<img src="https://img.shields.io/badge/CI-GitHub%20Actions-2088FF?style=flat-square&logo=github-actions&logoColor=white" alt="CI: GitHub Actions">
<img src="https://img.shields.io/badge/Infrastructure-Docker-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Infrastructure: Docker">
<img src="[Link](https://img.shields.io/badge/Build-pmbootstrap-blue?style=flat-square") alt="Build: pmbootstrap">
<img src="[Link](https://img.shields.io/badge/CI-GitHub%20Actions-2088FF?style=flat-square&logo=github-actions&logoColor=white") alt="CI: GitHub Actions">
<img src="[Link](https://img.shields.io/badge/Infrastructure-Docker-2496ED?style=flat-square&logo=docker&logoColor=white") alt="Infrastructure: Docker">
</p>

KibaTV is built using **pmbootstrap** inside a **Debian Trixie** **Docker** container via **GitHub Actions**.
Expand All @@ -181,14 +181,14 @@ KibaTV is built using **pmbootstrap** inside a **Debian Trixie** **Docker** cont
Requirements: **Docker**, a Linux host with at least 15 GB free space.

```bash
git clone https://github.com/WolfTech-Innovations/Kiba
git clone [Link](https://github.com/WolfTech-Innovations/Kiba)
cd Kiba
docker run --rm --privileged \
-v "$PWD:/w" \
-e RUN_NUM=local \
debian:trixie \
/w/scripts/kibatv-build.sh
```
```text

> [!NOTE]
> The build process is encapsulated in the `scripts/kibatv-build.sh` script and can be executed locally using Docker.
Expand All @@ -207,7 +207,7 @@ Kiba/
├── docs/ # In-depth documentation
├── Notes/ # Automatic release notes
└── README.md # Project documentation
```
```text

---

Expand Down
10 changes: 5 additions & 5 deletions WIKI.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,11 @@
</p>

<p align="center">
<a href="https://github.com/WolfTech-Innovations/Kiba/actions/workflows/kiba.yml">
<img src="https://img.shields.io/github/actions/workflow/status/WolfTech-Innovations/Kiba/kiba.yml?branch=main`&label=Build&style=for-the-badge" alt="Build Status">
<a href="[Link](https://github.com/WolfTech-Innovations/Kiba/actions/workflows/kiba.yml")>
<img src="[Link](https://img.shields.io/github/actions/workflow/status/WolfTech-Innovations/Kiba/kiba.yml?branch=main`&label=Build&style=for-the-badge") alt="Build Status">
</a>
<img src="https://img.shields.io/badge/License-MIT-purple?style=for-the-badge" alt="License">
<img src="https://img.shields.io/badge/Status-Stable-success?style=for-the-badge" alt="Status">
<img src="[Link](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge") alt="License">
<img src="[Link](https://img.shields.io/badge/Status-Stable-success?style=for-the-badge") alt="Status">
</p>

Welcome to the official **KibaTV Wiki**. This document provides an exhaustive deep-dive into the internals, design philosophy, and technical implementation of KibaTV.
Expand Down Expand Up @@ -139,7 +139,7 @@ KibaTV uses a highly automated CI/CD pipeline.
To reproduce the build environment on your own machine:

````bash
git clone [https://github.com/WolfTech-Innovations/Kiba](https://github.com/WolfTech-Innovations/Kiba)
git clone [[Link](https://github.com/WolfTech-Innovations/Kiba](https://github.com/WolfTech-Innovations/Kiba))
cd Kiba
docker run --rm --privileged \
-v "$PWD:/w" \
Expand Down
20 changes: 10 additions & 10 deletions docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
</p>

<p align="center">
<img src="https://img.shields.io/badge/Architecture-amd64-blue?style=for-the-badge" alt="Architecture">
<img src="https://img.shields.io/badge/Base-Debian`%20Trixie-D70A53?style=for-the-badge&logo=debian" alt="Base">
<img src="https://img.shields.io/badge/Kernel-CachyOS-orange?style=for-the-badge" alt="Kernel">
<img src="[Link](https://img.shields.io/badge/Architecture-amd64-blue?style=for-the-badge") alt="Architecture">
<img src="[Link](https://img.shields.io/badge/Base-Debian`%20Trixie-D70A53?style=for-the-badge&logo=debian") alt="Base">
<img src="[Link](https://img.shields.io/badge/Kernel-CachyOS-orange?style=for-the-badge") alt="Kernel">
</p>

---
Expand All @@ -20,13 +20,13 @@ This document provides a technical overview of the KibaTV architectural stack, f

````mermaid
graph TD
A[Hardware / VM] --> B[GRUB Bootloader]
B --> C[CachyOS Kernel]
C --> D[Debian 13 Trixie Base]
D --> E[Systemd Init]
E --> F[Wayland / X11]
F --> G[Plasma Bigscreen]
G --> H[KibaTV UX]
A[Hardware / VM] --> B[GRUB Bootloader]
B --> C[CachyOS Kernel]
C --> D[Debian 13 Trixie Base]
D --> E[Systemd Init]
E --> F[Wayland / X11]
F --> G[Plasma Bigscreen]
G --> H[KibaTV UX]
```bash

---
Expand Down
24 changes: 12 additions & 12 deletions docs/build-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
</p>

<p align="center">
<img src="https://img.shields.io/badge/CI-GitHub`%20Actions-2088FF?style=for-the-badge&logo=github-actions" alt="CI">
<img src="https://img.shields.io/badge/Tool-live--build-blue?style=for-the-badge" alt="live-build">
<img src="https://img.shields.io/badge/Container-Docker-2496ED?style=for-the-badge&logo=docker" alt="Docker">
<img src="[Link](https://img.shields.io/badge/CI-GitHub`%20Actions-2088FF?style=for-the-badge&logo=github-actions") alt="CI">
<img src="[Link](https://img.shields.io/badge/Tool-live--build-blue?style=for-the-badge") alt="live-build">
<img src="[Link](https://img.shields.io/badge/Container-Docker-2496ED?style=for-the-badge&logo=docker") alt="Docker">
</p>

---
Expand All @@ -20,14 +20,14 @@ KibaTV utilizes a highly automated CI/CD pipeline to generate reproducible ISO i

````mermaid
graph LR
A[Push to Main] --> B[GitHub Action]
B --> C[Setup Docker]
C --> D[lb config]
D --> E[Custom Hooks]
E --> F[lb build]
F --> G[ISO Generation]
G --> H[Verification]
H --> I[Upload to SourceForge]
A[Push to Main] --> B[GitHub Action]
B --> C[Setup Docker]
C --> D[lb config]
D --> E[Custom Hooks]
E --> F[lb build]
F --> G[ISO Generation]
G --> H[Verification]
H --> I[Upload to SourceForge]
```bash

---
Expand Down Expand Up @@ -83,7 +83,7 @@ You can reproduce the KibaTV build environment locally on any Linux machine with
### Build Steps

```bash
git clone [https://github.com/WolfTech-Innovations/Kiba](https://github.com/WolfTech-Innovations/Kiba)
git clone [[Link](https://github.com/WolfTech-Innovations/Kiba](https://github.com/WolfTech-Innovations/Kiba))
cd Kiba
docker run --rm --privileged \
-v "$PWD:/w" \
Expand Down
8 changes: 4 additions & 4 deletions docs/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,8 @@
</p>

<p align="center">
<img src="https://img.shields.io/badge/Status-Welcome-success?style=for-the-badge" alt="Welcome">
<img src="https://img.shields.io/badge/License-MIT-purple?style=for-the-badge" alt="License">
<img src="[Link](https://img.shields.io/badge/Status-Welcome-success?style=for-the-badge") alt="Welcome">
<img src="[Link](https://img.shields.io/badge/License-MIT-purple?style=for-the-badge") alt="License">
</p>

---
Expand All @@ -24,10 +24,10 @@ To begin contributing to the KibaTV build system or customization hooks, follow
3. **Local Build:** Run a local build to ensure your environment is working:

```bash
git clone [https://github.com/YOUR_USERNAME/Kiba](https://github.com/YOUR_USERNAME/Kiba)
git clone [[Link](https://github.com/YOUR_USERNAME/Kiba](https://github.com/YOUR_USERNAME/Kiba))
cd Kiba
docker run --rm --privileged -v "$PWD:/w" -e RUN_NUM=local debian:trixie /w/build.sh
```
```text

---

Expand Down
Loading
Loading