Pixie-Cat

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #go #deep-learning #linux #docker #macos #nodejs #vue #pytorch #mcp #openai #open-source

(★ 18)

A playful desktop companion cat built with GTK, featuring interactive modes like attack, happy, run, and sad — reacts to your clicks, scrolls, and cursor movements.

Pixie-Cat 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Pixie Cat 🐱✨

**Pixie Cat** is a tiny pixelated cat living on your screen.  
The cat has a soul and lives with you all the time — through your good and bad memories.  
With Pixie Cat, you’re never truly alone.

![Pixie Cat Demo](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/demo.gif)

---

## Why This Exists

Pixie Cat started as a project for fun — a reminder that:

> Code isn’t just for solving problems.  
> It’s also for exploring ideas, expressing creativity, and building something just because it sparks joy.

It made me realize: **you can create a soul with coding**.  
And maybe, just maybe, it can make someone’s day a little better.

---

## About This Project

The pixel art cat assets are from the amazing free sprite pack:  
🎨 **[Tiny Cat by Kirisoft Store](https://kirisoft-store.itch.io/free-tiny-cat-with-all-animations)**

Pixie Cat runs on **Windows** and **Linux** (both Wayland and X11) — so whether you’re on your desktop or your laptop, your tiny companion is always with you.

---

## Features & Modes

Pixie Cat has multiple moods and animations. Each one reflects a part of your cat’s playful (and sometimes mysterious) life:

- **Attack** — Happens when the cursor is close to the cat.  
  ![Attack](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/attack.gif)

- **Dead** — Happens when you quit or kill the program (sad emote).  
  ![Dead](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/dead.gif)

- **Happy** — Happens when you scroll up or down on the cat.  
  ![Happy](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/happy.gif)

- **Idle** — The cat’s normal resting state.  
  ![Idle](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/idle.gif)

- **Run** — Happens when you left-click on the cat.  
  ![Run](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/run.gif)

- **Sit** — When the cat feels relaxed enough to sit.  
  ![Sit](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/sit.gif)

- **Walk** — The cat moves around your screen in a calm manner.  
  ![Walk](https://github.com/moeinEN/Pixie-Cat/blob/main/demo/walk.gif)

---

## Dependencies

Before installing, make sure you have:

- **Python** ≥ 3.10  
- **GTK 4**  
- **PyGObject** (for GTK integration)  
- **pkg-config** (for building GTK Python bindings)

---

## Installation

### Windows
1. Make sure Python ≥ 3.10 is installed.  
2. Install GTK 4 for Windows.  
3. Install dependencies:  
   ```bash
   pip install pygobject
   ```

4. Clone the repository and run:

```bash
   python -m pixie
   ```
5. Or, simply run the prebuilt `.exe` from the releases page.

---

### Linux (Wayland & X11)

1. Install `GTK 4`, `PyGObject`, and `pkg-config` via your package manager.
2. Install Pixie Cat with:

```bash
   pip install pixie_cat-0.1.0-py3-none-any.whl --system-site-packages
   ```
3. Run it with:

```bash
   pixie & disown
   ```

## Command-Line Options

Pixie Cat can be customized when you start it. You can change the **scale**, **color**, and **speed** of your cat.

```bash
pixie --scale <factor> --color <hex> --speed <multiplier>
```

**Options:**

* `--scale` — Adjusts the size of the cat.
  Example:

```bash
  pixie --scale 2.0   # Twice as large
  pixie --scale 0.5   # Half the size
  ```

* `--color` — Changes the color tint of the cat using a HEX color code.
  Example:

```bash
  pixie --color "#FF69B4"   # Pink cat
  pixie --color "#00FFFF"   # Cyan cat
  ```

* `--speed` — Controls the animation speed.
  Example:

```bash
  pixie --speed 0.5   # Slower animations
  pixie --speed 2.0   # Faster animations
  ```

You can combine options:

```bash
pixie --scale 1.5 --color "#FFD700" --speed 1.2
```

---

Pixie-Cat

Pixie-Cat 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Pixie-Cat

Pixie-Cat 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README