Skip to content

Professional Linux driver for Deepcool Digital CPU coolers with real-time temperature display

License

Notifications You must be signed in to change notification settings

philling-dev/deepcool-digital-linux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌑️ Deepcool Digital Linux Driver

License Platform Distro Version GitHub stars

Professional Linux driver for Deepcool Digital CPU coolers
Real-time CPU temperature display on your cooler's built-in screen

πŸ“₯ Download β€’ πŸ“š Documentation β€’ πŸ› Issues β€’ πŸ’– Support


⭐ Key Features

🌑️ Real-Time Monitoring

  • Live CPU temperature display on cooler screen
  • 750ms refresh rate for instant updates
  • Support for both Celsius and Fahrenheit

βš™οΈ Multiple Display Modes

  • temp - Temperature monitoring (default)
  • usage - CPU usage percentage
  • auto - Automatic mode switching

🚨 Smart Alarm System

  • Visual alerts at 85Β°C / 185Β°F
  • Configurable temperature thresholds
  • Command-line alarm control

πŸ”§ Professional Integration

  • Native systemd service support
  • Automatic boot initialization
  • Runs without root privileges
  • Clean installation and removal

πŸ–₯️ Compatibility

Operating Systems

  • βœ… Ubuntu 20.04+ (LTS versions recommended)
  • βœ… Debian 11+ (Bullseye, Bookworm, Testing)
  • βœ… Linux Mint 20+ (Tested on 22.1 Xia ✨)
  • βœ… Pop!_OS 20.04+ (Gaming-optimized)
  • βœ… Ubuntu variants (Kubuntu, Xubuntu, Lubuntu, etc.)
  • βœ… Elementary OS, Zorin OS, KDE neon
  • βœ… All Debian-based distributions

Supported Hardware

Device Status Tested
AK500S DIGITAL βœ… Fully Supported βœ… Verified
AK500 DIGITAL βœ… Supported ⚠️ Community
AK400 DIGITAL βœ… Supported ⚠️ Community
AK620 DIGITAL βœ… Supported ⚠️ Community
AG400 DIGITAL βœ… Supported ⚠️ Community
AG620 DIGITAL βœ… Supported ⚠️ Community
LD240 βœ… Supported ⚠️ Community
LD360 βœ… Supported ⚠️ Community

πŸ“₯ Installation

πŸš€ Method 1: Debian Package (Recommended)

# Download the latest release
wget https://github.com/philling-dev/deepcool-digital-linux/releases/latest/download/deepcool-ak500s-digital_1.0.0_amd64.deb

# Install the package
sudo dpkg -i deepcool-ak500s-digital_1.0.0_amd64.deb

# Start the service
sudo systemctl start deepcool-digital

⚑ Method 2: Automated Script

# One-line installation
curl -fsSL https://raw.githubusercontent.com/philling-dev/deepcool-digital-linux/main/install.sh | bash

πŸ”§ Method 3: Manual Build

# Install dependencies
sudo apt update
sudo apt install git build-essential libusb-1.0-0-dev libudev-dev

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# Clone and build
git clone https://github.com/shakil89427/deepcool-ak500-digital-linux.git
cd deepcool-ak500-digital-linux
cargo build --release

# Install system-wide
sudo cp target/release/deepcool-digital-linux /usr/sbin/
sudo systemctl enable --now deepcool-digital

πŸ” Usage

Basic Commands

# List connected devices
sudo deepcool-digital-linux --list

# View help and options
sudo deepcool-digital-linux --help

# Run with temperature mode and alarm
sudo deepcool-digital-linux --mode temp --alarm

# Use Fahrenheit instead of Celsius
sudo deepcool-digital-linux --fahrenheit

Service Management

# Check service status
sudo systemctl status deepcool-digital

# Start/Stop service
sudo systemctl start deepcool-digital
sudo systemctl stop deepcool-digital

# View real-time logs
sudo journalctl -u deepcool-digital -f

Configuration Options

Option Description Example
--mode <MODE> Display mode: temp, usage, auto --mode usage
--fahrenheit Use Fahrenheit instead of Celsius --fahrenheit
--alarm Enable temperature alarm --alarm
--pid <ID> Specify device Product ID --pid 4
--list List connected Deepcool devices --list

πŸ”§ Troubleshooting

Device Not Detected
# Check if device is connected
lsusb | grep -i deepcool

# Verify permissions
ls -la /dev/hidraw*

# Reload udev rules
sudo udevadm control --reload-rules
sudo udevadm trigger
Service Won't Start
# Check detailed logs
sudo journalctl -u deepcool-digital -n 50

# Test manual execution
sudo deepcool-digital-linux --list

# Verify executable permissions
sudo chmod +x /usr/sbin/deepcool-digital-linux
Permission Denied Errors
# Add user to plugdev group
sudo usermod -a -G plugdev $USER

# Reload udev rules
sudo udevadm control --reload-rules
sudo udevadm trigger

# Logout and login again

πŸ—‘οΈ Uninstallation

# Via package manager (if installed via .deb)
sudo apt remove deepcool-ak500s-digital

# Manual removal
sudo systemctl stop deepcool-digital
sudo systemctl disable deepcool-digital
sudo rm /usr/sbin/deepcool-digital-linux
sudo rm /etc/systemd/system/deepcool-digital.service
sudo rm /etc/udev/rules.d/99-deepcool-digital.rules
sudo systemctl daemon-reload

πŸ’– Support Development

If this driver has been helpful to you, please consider supporting its continued development!

β˜• Buy me a coffee

πŸͺ™ Bitcoin

To donate, copy the address below:

1Lyy8GJignLbTUoTkR1HKSe8VTkzAvBMLm

🎯 How Your Support Helps

  • πŸ”§ Development of new features and improvements
  • πŸ› Bug fixes and rapid issue resolution
  • πŸ“± Hardware support expansion to new devices
  • πŸ“š Documentation and user guide improvements
  • ⚑ Regular updates and maintenance

🀝 Contributing

Contributions are welcome! Please see our Contributing Guide for details.

How to Contribute

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch (git checkout -b feature/awesome-feature)
  3. πŸ“ Commit your changes (git commit -am 'Add awesome feature')
  4. πŸ“€ Push to the branch (git push origin feature/awesome-feature)
  5. πŸ”„ Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

πŸ“Š Project Statistics

GitHub stars GitHub forks GitHub issues GitHub downloads


⭐ If this project helped you, please give it a star! ⭐

Made with ❀️ for the Linux (https://github.com/philling-dev)

Keywords: linux, deepcool, cpu cooler, driver, temperature, monitoring, digital display, ak500s, ak400, ak620, ag400, ag620, ld240, ld360, systemd, hardware control

About

Professional Linux driver for Deepcool Digital CPU coolers with real-time temperature display

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages