Skip to content

ac999/drift_dancer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚗 Drift Dancer (Desktop Buddy)

A lightweight, cross-platform desktop buddy for car enthusiasts. Brings a drifting BMW directly to your desktop, complete with dynamic smoke particles, "Always on Top" functionality, and car culture memes.

Built with Python and PyQt6 for maximum performance and perfect transparency across Windows, macOS, and Linux (including Ubuntu/Wayland).

preview

✨ Features

  • Cross-Platform: Runs flawlessly on Windows 10/11, macOS, and Linux.
  • Wayland/X11 Support: Bypasses strict Linux window managers to remain sticky across all virtual desktops.
  • Lightweight: Low RAM and CPU footprint thanks to delta-time frame animation.
  • Custom UI: Frosted glass text bubbles with car culture/drift memes.

🚀 How to Run from Source

  1. Clone the repository:
git clone git@github.com:ac999/drift_dancer.git
cd drift_dancer
  1. Install dependencies using uv:
uv pip install --system PyQt6 pyinstaller
  1. Run the app:
uv run main.py

📦 How to Build Standalone Executables (Releases)

To build a standalone executable (.exe, .app, or Linux binary) so users don't need Python installed, we use PyInstaller driven by uv.

For Windows:

uv run pyinstaller --noconsole --onefile --add-data "frames;frames" main.py

For macOS / Linux:

uv run pyinstaller --noconsole --onefile --add-data "frames:frames" main.py

Note: The compiled executable will be located in the dist/ folder.

🐧 Post-Install (Linux Only)

After downloading the Linux binary, grant it execution permissions:

chmod +x main
./main

⌨️ Controls

  • Close App: Press Escape while the application is focused.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages