Skip to content

Curzyori/anime-cursor

Repository files navigation

demo.mp4

Anime Cursor Logo

Anime Cursor

Cross-Platform Desktop Animated Cursor Manager

Stars Forks License Platform

Why · Features · Tech Stack · Architecture · Quick Start · Installation · Preview · Support · License

🌐 In 4+ languages - 🇺🇸 EN · 🇮🇩 ID · 🇨🇳 CN · 🇯🇵 JP


🕒 Why Anime Cursor?

Tired of digging through Control Panel or editing registry just to try an anime cursor pack? Anime Cursor is a cross-platform desktop app that makes browsing, importing, and applying animated cursor (.ani) packs dead simple - without hunting for Settings panels or writing terminal commands.

One-Click Apply Auto-detects your OS - no manual selection needed
Pack-Based Management Import ZIPs with multiple cursor variants in one go
Auto Backup & Restore Cursor backup before every apply - safe recovery anytime
Fully Offline Zero network requests, zero telemetry - absolute privacy
Cross-Platform Windows 10+ and Linux (GNOME, KDE, XFCE)

🎯 Key Features

Feature Status Description
Pack Import Drag-drop ZIP or individual .ani - auto-extract and parse
Dashboard Grid Browse all installed packs with sort by name/date
Pack Detail View Per-variant preview with apply button
One-Click Apply Auto OS detection - Windows registry or Linux Xcursor
Auto Backup Saves current cursor before every apply
Restore Default Revert to OS default cursor from Settings
Multi-Language UI EN, ID, CN, JP with one-click selector
Dark/Light Theme Persistent theme switcher
Collapsible Sidebar Icon-only compact mode

🛠️ Tech Stack

  • Desktop Framework: Tauri v2 (Rust + webview)
  • Frontend: React 18 + TypeScript + Tailwind CSS
  • State: Zustand (app state) + Tauri IPC (async commands)
  • Build: Vite 6
  • Backend: Rust (serde, zip, winreg, xcursor)
  • Format: .ani RIFF animated cursor + .zip pack

🏗️ Architecture

anime-cursor/
├── src-tauri/           # Rust backend
│   ├── src/
│   │   ├── main.rs      # Tauri entry, commands
│   │   ├── parser.rs    # .ANI RIFF parser
│   │   ├── applier.rs   # Cursor apply/restore (Win + Linux)
│   │   ├── pack.rs      # ZIP extract, metadata read
│   │   └── backup.rs    # Cursor backup management
│   ├── icons/           # App icons per platform
│   └── Cargo.toml
├── src/                 # React frontend
│   ├── App.tsx
│   ├── pages/
│   │   ├── Dashboard.tsx
│   │   ├── Import.tsx
│   │   ├── PackDetail.tsx
│   │   └── Settings.tsx
│   ├── components/
│   ├── i18n/            # EN, ID, CN, JP language files
│   ├── hooks/
│   ├── styles/
│   └── types/
├── public/
│   └── logo.svg
├── .example/            # Reference cursor packs for testing
├── package.json
└── tauri.conf.json

🚀 Quick Start

Download the latest release from Releases.

Available Formats

Platform Format When to Use
Linux (Debian/Ubuntu) .deb Double-click to install
Linux (Fedora/RHEL) .rpm Double-click to install
Linux (any distro) .AppImage No install needed — chmod +x & run
Windows 10+ .msi Double-click to install

System Requirements

Minimum Recommended
CPU 2 cores 4+ cores
RAM 512 MB 2 GB+
Storage 150 MB 500 MB
OS Windows 10 / Linux (GNOME, KDE, XFCE) Windows 11 / Linux latest

Quick Install (Linux AppImage)

chmod +x Anime\ Cursor_*_amd64.AppImage
./Anime\ Cursor_*_amd64.AppImage

📦 Installation

Build from source (Node 18+):

git clone https://github.com/Curzyori/anime-cursor.git
cd anime-cursor
npm install
npm run tauri build

The binary will be at src-tauri/target/release/anime-cursor.

System dependencies (Linux):

sudo apt install libwebkit2gtk-4.1-dev libxdo-dev libayatana-appindicator3-dev

🖼️ Preview

Dashboard Pack Detail
Dashboard Pack Detail
Import Settings
Import Settings

☕ Support

If you find this project useful, please consider giving it a ⭐ Star or 🍴 Forking it to show support and keep me motivated to build more exciting open-source projects! Every single star and fork means a lot.

Your donations keep my projects free and open source. Every contribution matters, and your support helps me continue building exciting open-source projects in the future.

Support this project by buying me a coffee! 💝

Buy Me A Coffee

⚖️ License

GPL-3.0 - see LICENSE.

Built with passion as the 22nd project of the 50 Projects Challenge by **@Curzyori**

About

Cross-Platform Desktop Animated Cursor Manager — browse, import, and apply .ani cursor packs on Windows & Linux

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages