Cursor_Flame

A stunning flame particle effect that follows your mouse cursor.

Preview

Flame Trail

Click Effect

Hold Click - Burnout Mode

Scroll Effect

Features

• Realistic flame particles that follow your cursor
• Dynamic color transitions (orange to yellow to blue to purple)
• Click effects with lightning burst animation
• Scroll wheel creates directional flame particles
• Hold-click "burnout" mode with intensifying flames
• Smooth particle physics with wobble, drag, and gravity
• Sparks and smoke effects
• Transparent overlay - works on top of any application

Downloads

C++ Native Version (Recommended)

Lightweight, high-performance native binaries:

Platform	Version	Download	Size	Features
Linux	v2.5	KursorFlame_linux_cpp_2.5.zip	~310 KB	Full customization, themes, gradients
Linux	v2	KursorFlame_linux_cpp_2.zip	~300 KB	GPU accel, themes, config
Linux	v1	KursorFlame_linux_cpp.zip	~65 KB	Basic flame effect
Windows	v1	Cursor_Flame_cpp.zip	~300 KB	Basic flame effect

Python Version

Platform	Download	Size
Windows	Cursor_Flame.zip	~28 MB

Version Comparison

Feature	v1	v2	v2.5
Basic flame effect	✅	✅	✅
Toggle/Close hotkeys	✅	✅	✅
GPU acceleration	❌	✅	❌ (CPU optimized)
Themes (Fire/Snow/Water)	❌	✅	✅
Custom colors	❌	✅	✅
Config file	❌	✅	✅
Quality presets	❌	✅ (4)	✅ (5 incl. custom)
Physics customization	❌	✅	✅
Custom quality profile	❌	❌	✅
10-level color gradient	❌	❌	✅
Sub-effect colors	❌	❌	✅
Wave/trail dynamics	❌	❌	✅
Render styles	❌	❌	✅ (3 styles)
Particle capacity	200	5,000	30,000

Hotkeys

Hotkey	Action
Ctrl+Alt+E	Toggle effect ON/OFF
Ctrl+Alt+Q	Close KursorFlame

Installation

Windows

Option 1: Download Release (Recommended)

1. Download Cursor_Flame_cpp.zip (C++ version) or Cursor_Flame.zip (Python version) from Releases
2. Extract and run run.bat or Cursor_Flame.exe

Option 2: Run from Source

git clone https://github.com/HAKORADev/Cursor_Flame.git
cd Cursor_Flame
pip install PyQt5 pynput
python cf.py

Linux

Option 1: Download Release (Recommended)

1. Download KursorFlame_linux_cpp_2.5.zip (v2.5 - recommended) from Releases
2. Extract and run:

cd KursorFlame
chmod +x KursorFlame *.sh
./run.sh
# or directly: ./KursorFlame

Option 2: Build from Source

# Requires X11 development libraries
# Ubuntu/Debian: sudo apt install libx11-dev libxrandr-dev libxi-dev

# v1
g++ -O2 -o KursorFlame kf.cpp -lX11 -lXrandr -lXi -lpthread

# v2 (with GPU support - requires OpenGL)
g++ -O2 -o KursorFlame kf2.cpp -lX11 -lXrandr -lXi -lGL -lpthread

# v2.5 (CPU dual-core optimized)
g++ -O2 -o KursorFlame kf2.5.cpp -lX11 -lXrandr -lXi -lpthread
./KursorFlame

Requirements

Windows

• Windows 10/11
• Python 3.7+ (if running from source)
• PyQt5, pynput (if running from source)

Linux

• X11 display server (Xorg)
• libX11, libXrandr, libXi

Usage

Simply run the application and move your mouse around. The flame effect will appear automatically.

Action	Effect
Move mouse	Flame trail follows cursor
Click	Lightning burst effect
Hold click	Intensifying burnout flames
Scroll	Directional flame burst
Fast movement	Fireball mode with trailing flames

Configuration (v2.5 Linux)

Edit kursor.conf to customize all effects:

[General]
tail = 1               # Enable trailing particles
on_click = 1           # Enable click effects
on_hold = 1            # Enable burnout mode
on_scroll = 1          # Enable scroll effects
strike = 1             # Enable fast-movement flash
interactive_edges = 1  # Particles bounce off screen

[Visuals]
quality = 4            # 0=Low, 1=Med, 2=High, 3=Ultra, 4=Custom
theme = 0              # 0=Fire, 1=Snow, 2=Water, 4=Custom

[Physics]
gravity_mult = 1.0     # Vertical pull (negative = up)
flicker_mult = 1.0     # Particle jitter
wind_x = 0.0           # Horizontal push
wind_y = 0.0           # Vertical push

[Quality]              # Used when quality = 4
q_spawn_base = 30      # Particles per tick (0-5000)
q_smoke_max = 100      # Max smoke particles (0-5000)
particle_life_sec = 1.0 # Particle lifespan (0-600)
q_particle_size = 1.0  # Size multiplier (0-10)
q_softness = 2.5       # Blur radius (0-15)
q_jitter_int = 1.0     # Flicker intensity (0-10)
q_smoke_blend = 1      # 0=Additive, 1=Alpha
q_render_style = 1     # 0=Teardrop, 1=Soft, 2=Shaded

[SubEffects]
overall_opacity = 220  # Master alpha (0-255)
# Strike effect (fast click while moving)
strike_r = 200
strike_g = 255
strike_b = 255
strike_a = 255
# Click effect
click_r = 255
click_g = 255
click_b = 200
click_a = 255
# Scroll effect
scroll_r = 255
scroll_g = 50
scroll_b = 20
scroll_a = 220
# Tail dynamics
tail_len_mult = 1.0    # Trail length (0.1-10)
tail_thick_mult = 1.0  # Trail thickness (0.1-10)
wave_amp = 0.0         # Wave amplitude (0-100)
wave_freq = 0.1        # Wave frequency (0-5)

[CustomTheme]          # Used when theme = 4
gradient_speed = 60.0
gradient_reverse_speed = 60.0
l0_r = 255  l0_g = 100  l0_b = 50
l1_r = 235  l1_g = 110  l1_b = 60
# ... l2 through l9 for 10-level gradient

Included Scripts

Windows (.bat)

Script	Description
run.bat	Launch Cursor Flame
kill.bat	Stop Cursor Flame
startup_ON.bat	Enable auto-start with Windows
startup_OFF.bat	Disable auto-start

Linux (.sh)

Script	Description
run.sh	Launch KursorFlame
kill.sh	Stop KursorFlame
startup_ON.sh	Enable auto-start (XDG autostart)
startup_OFF.sh	Disable auto-start

Building the Executable

Python Version (Windows)

pip install pyinstaller
pyinstaller --onefile --windowed --icon=cf_ico.ico cf.py

C++ Version (Windows)

# MSVC
cl /O2 /EHsc /Fe:Cursor_Flame.exe cf.cpp user32.lib gdi32.lib winmm.lib

C++ Version (Linux)

# v1
g++ -O2 -o KursorFlame kf.cpp -lX11 -lXrandr -lXi -lpthread

# v2 (with OpenGL/GPU support)
g++ -O2 -o KursorFlame kf2.cpp -lX11 -lXrandr -lXi -lGL -lpthread

# v2.5 (CPU dual-core optimized)
g++ -O2 -o KursorFlame kf2.5.cpp -lX11 -lXrandr -lXi -lpthread

License

MIT License - feel free to use and modify!

Contributing

Pull requests are welcome! Feel free to open issues for bugs or feature requests.