/Aurora

Unified lighting effects across multiple brands and various games.

Primary LanguageC#MIT LicenseMIT

Aurora - Unified Lighting Effects

Aurora Logo

Link to Aurora's webpage, includes some demos and changelogs

Latest Version Total Downloads Build status Build status

Project Aurora is a utility that unifies RGB lighting devices across different brands and enables them to work alongside each other, all while adding and improving RGB lighting support for various games that previous had none or little RGB lighting support. Aurora is mainly written in C#, but has C++ components to implement native support for other games.

Download

Latest stable release

Most recent release (potentially unstable)

Bleeding-edge builds (decent chance they're going to have issues)

Discord Server

Having issues? Want to discuss changes or talk about possible features? Want to be involved in the development and design process of Aurora? Join our Discord server and get involved!

How to Install

AUTOMATIC

  1. Download the 'Aurora-setup-vX.X.X.exe' from any of the options found under the Download section, every recent release should have this available
  2. Run the executable and install it, all requirements should be installed for you.
  3. Start using Aurora!

MANUAL

  1. First of all, make sure that your PC meets the requirements listed above. Also, make sure that you have Visual C++ Redistributable Packages for Visual Studio 2017 and Microsoft .NET Framework 4.6.1 installed.
  2. Download the latest release from above
  3. Extract the archive anywhere on your computer. Preferably keep it in a location you can easily access.
  4. Run "Aurora.exe", from that point, Aurora should provide you with further instructions and options.

Natively Supported Games

  • American Truck Simulator
  • Battlefield 1
  • Battlefield 3
  • Blacklight: Retribution
  • Blade and Soul
  • Borderlands 2
  • Clone Hero
  • CS:GO
  • DOOM (2016)
  • Diablo III
  • Dishonored
  • Dota 2
  • Dying Light
  • Euro Truck Simulator 2
  • Evolve Stage 2
  • Factorio
  • Grand Theft Auto V
  • Guild Wars 2
  • Hotline Miami
  • Killing Floor 2
  • League of Legends
  • Magic: The Gathering - Duels of the Planeswalkers 2012
  • Metro: Last Light
  • Middle-earth: Shadow of Mordor
  • Minecraft
  • Move or Die
  • Osu!
  • Overwatch
  • Payday 2
  • Quake Champions
  • Quantum Conumdrum
  • Resident Evil 2 (2019)
  • Rise of the Tomb Raider
  • Robot Roller-Derby Disco Dodgeball
  • Rocket League
  • Serious Sam 3
  • Subnautica
  • The Division
  • The Talos Principle
  • The Witcher 3
  • Worms W.M.D
  • XCOM: Enemy Unknown

Natively Supported Devices

If you don't see some of these devices in the menu, select a similar one and it will probably work. Submit an issue for proper support in the interface! Devices from supported brands generally should work even if they aren't listed here.

Logitech

  • Most Logitech Lightsync devices should work

Keyboards

  • G410
  • G512
  • G513
  • G810
  • G910
  • GPRO

Mice

  • G203
  • G300s (seven colors supported)
  • G403
  • G502
  • G703
  • G900
  • G903
  • GPRO

Corsair

  • Most Keyboards, Mice, Headsets and mousepads should work.

Keyboards

  • K65
  • K68
  • K70 LUX
  • K95
  • K95 Platinum
  • STRAFE Non-RGB/RGB

Mice

  • Dark Core RGB
  • Glaive RGB
  • M65 RGB
  • Scimitar RGB

Other Peripherals

  • MM800 Mousepad
  • ST100 Headset Stand

Razer

  • Most Chroma enabled devices should work

Keyboards

  • BlackWidow Chroma
  • Huntsman
  • Huntsman Elite

Mice

  • Abyssus Essential
  • Basilisk
  • DeathAdder Elite
  • Lancehead
  • Mamba & Elite
  • Naga Hex/Trinity

Mousepads

  • Firefly

Cooler Master

  • Masterkeys Pro L, M and S RGB/White
  • CK372
  • CK551
  • CK552
  • MK750

Roccat

Keyboards

  • Ryos MK FX

Mice

  • Kone Pure

SteelSeries

Keyboards

  • Apex M750
  • Apex M750 TKL
  • Apex M800

Mice

  • Rival 300
  • Rival 310
  • Rival 600
  • Rival 700

Wooting

  • One
  • Two

Alienware

  • All laptop models until AW15 R3/AW17 R4 (AW broke support for per-key RGB)

Clevo

AtmoOrb

Dualshock 4 (PS4 Controller)

Drevo

  • Blademaster

SoundBlasterX

  • Vanguard K08

Video demonstrations

Clone Hero Demo

Clone Hero Demo

Dota 2 Demo

Dota 2 Demo

Grand Theft Auto V Demo

Grand Theft Auto V Demo

osu! Demo

Ant's osu! Demo

Robot Roller-Derby Disco Dodgeball Demo

Robot Roller-Derby Disco Dodgeball Demo

Rocket League Demo

Rocket League Demo

Screenshots

Desktop Settings Dota 2 Settings CSGO Settings GTA 5 Settings Rocket League Settings Payday 2 Settings Euro Truck Simulator 2 / American Truck Simulator Settings Skype Integration Settings

In-depth features

General

  • Display volume percentage on the keyboard
  • Display CPU and Memory usage on the keyboard
  • Layering system for effects
  • Define custom layers with individual effects
  • Key selection via freeform region
  • Customizable “away from keyboard” effects
  • Set global peripheral brightness on the fly without having to leave your game
  • Completely turn off peripheral lights after a specific time
  • Interactive keyboard effects such as: Key Fade, Key Wave, and Arrow Flow
  • Preview lighting effects without having to launch the game
  • Simultaneous support for different brands of RGB peripheral devices
  • Support for a wide range of models from all the top brands of RGB peripherals
  • Support for almost any Logitech LED and Razer Chroma supported games
  • Add other programs to define custom lighting layers for daytime and nighttime themes
  • Display shortcut keys with Shortcuts Assistant
  • Automatic updater
  • Ability to select your preferred keyboard layout and brand
  • Ability to select your mouse, and it's orientation (left/right handed)
  • Import/Export for profile settings
  • Customizable gradient layers
  • Scripting support for custom lighting effects & custom devices

Battlefield 1 features

  • Flashes red when the player takes damage.
  • Lights up keybindings.

Borderlands 2 features

  • Health and Shield indicators

Clone Hero features

  • Note Streak Indicator
  • Star Power Percentage Indicator
  • Note Hit Animation
  • Fret Press Indicator
  • Star Power Activation Indicator & Color Overrides
  • FC Indicator
  • Menu Effects
  • Flashes red when a player misses a note or overstrums

CS:GO features

  • Team-based background lighting
  • Health and Ammo indicators
  • Bomb effect
  • Kill indicators
  • Burning and Flashbang effects
  • Chat/Console typing keys

DOOM features

  • Animation on kills and glory kills
  • Animation on item pickups

Diablo III features

  • Ability cooldowns
  • Health and damage indicators
  • Legendary item pickup animations

Dishonored features

  • Health and Mana indicators.
  • Potion indicators.

Dota 2 features

  • Team-based background lighting
  • Respawn effect
  • Killstreak effect
  • Health and Mana indicators
  • Ability and Item indicators
  • Hero ability effects

Dying Light features

  • Background lighting changes according to time of day, health, and flashlight
  • All keybindings with a color for each category

Euro Truck Simulator 2 / American Truck Simulator features

  • Throttle/braking indicators
  • RPM meter
  • Blinkers
  • Beacons
  • Fuel/air pressure indicators
  • Ignition indicator

Factorio features

  • Loading bar on startup
  • Health indicator
  • Research done alerts

Grand Theft Auto V features

  • Dynamic background lighting (based on current character or race position)
  • Custom police siren effects

Hotline Miami features

  • Hotline Miami has a slowly alternating color effect.

Killing Floor 2 features

  • Static red on main menu
  • Low Health and death indicators
  • Blue flash when healing
  • White during zed time
  • Red flash on incoming wave
  • Fire and Puke indicator flashes

League of Legends features

  • Teammate pings
  • Low health and Damage taken
  • Grey on death

Minecraft features

  • Healthbar
  • XP bar
  • Armor and hunger bars (not on the default profile but can easily be added)
  • Flame effect when player burns
  • Raindrops when world is raining
  • Background based on time-of-day

Move or Die features

  • WASD, TFGH, IJKL and Arrows lighting up with their respective player colors.
  • Flash red followed by the player color if a player dies.
  • Round winning player colored flashes.
  • Match winning player colored pulses.
  • Rapid white flashes when leveling up.
  • Rapid red flashes while sudden death.
  • Synchronized yellow warning flashes idle warning in lobby.
  • Colored waves based on the item rarity of the unlocked item.

Osu! features

  • Health and accuracy meters
  • Animations for missing beats and losing combos
  • Animations when you hit a beat

Overwatch features

  • Different color depending on hero
  • Ability cooldown indicators
  • Ultimate indicator and animation (for certain heroes)
  • Lights up keybindings

Payday 2 features

  • Assault-based background lighting effects
  • Suspicion background effect
  • Player health and ammo indicators

Quake Champions features

  • Different color depending on chosen champion
  • Lights up keybinds with each weapons color

Quantum Conumdrum features

  • Changes color based on what dimension the player is in

Rocket League features

  • Team-based background lighting
  • Score-split for background effect
  • Boost indicator
  • Goal Explosions

Subnautica features

  • Depth indicator
  • Health, water, oxygen, and hunger indicator
  • PDA status

The Division features

  • Burn indicators
  • Ability cooldowns
  • Ammo indicator
  • Lights up keybindings

The Talos Principle features

  • Changes color based on the puzzle color the player is in

The Witcher 3 features

  • Current active sign as background
  • Health, Toxicity, and Stamina indicators

F.A.Q.

Can this give me a ban in a video game?

Support for all included games is tested to be sure not to trigger any anti-cheats or produce any suspicious behavior. With that said, the software is to be used at your own risk. We cannot prevent game developers from adding anti-cheats or blocking ways Aurora retrieves information from the game.

Are you going to support more devices?

Yes, we are going to support anything that has an SDK.

I can't find an option for my Device in the settings!

Those listed are purely different layouts, if your device is made by a brand that is supported, try selecting a device that has a similar layout to yours and see if that works! If not, check if the integration is connected under 'Device Manager', if you can't get it to connect, check if there is an issue open for your device, if not, feel free to open one.

Are you going to support more games?

Yes, we will be looking into requested games. You can suggest/request game support here.

Are you open to doing collaborations with other RGB projects or game companies?

Definitely! If you have a project that you think can fit Aurora, feel free to send me an e-mail.

I would like to request support for a game, how do I do that?

You can make suggestions by posting an issue here, outlining what you would like to request, and I will look over it.

Some keys in the program state that they are not supported. What does this mean?

It means that changes to those keys are not currently possible. When it's possible to change those keys via SDK, then their support will be added.

Aurora is constantly crashing! Help!

You can report crashes and other issues on Github. Please include a brief explanation of how to reproduce the crash and include the most recent log file. Log files can be located in the "%appdata%/Aurora/Logs" directory, or by going to Settings -> Debug and clicking 'Show Logs Folder'.

I have found a bug. How do I report it?

You can report bugs here, by creating a new Issue here. Before posting an issue, please try and see if there is an issue the same as yours that has already been posted, if not, then feel free to post a new one.

I wish to expand this, fix bugs, and add my own features.

Feel free to fork this repo and make pull requests with your own code. I am open for suggestions for both features and optimization. :)

What is the purpose of this utility?

The main goal of Aurora is to allow RGB peripheral devices to work alongside other RGB peripheral devices from other brands. Meaning, if you own a combination of Logitech, Razer, or Corsair peripheral devices, they should be able to work together.

Secondary goal of Aurora is to integrate RGB lighting into popular games. RGB lighting is a nifty feature that is often underused, and as a result gamers with RGB gear are unable to utilize the lighting effects that they paid for.

Development Team

  • simon-wh Lead Developer (since May 2017), Developer (July 2016 - May 2017)
  • Antonpup Owner, Lead Developer (until May 2017)

Minor Announcement

I (@Antonpup) will no longer be able to develop this project further due to my new future job. I have handed over the project development to @Simon W. He has access to everything in order to push new updates and upkeep the project. I will keep this project on my Github account, as it is part of my portfolio. I hope you enjoy the work Simon will be putting into this project. Some of you will see my work again in the near future.

Support the Project

Contribute

If you're a developer or just a software user you can help the project by:

  • Opening an issue to report any bugs you experience (please see if an issue already exists before opening an issue)
  • Trying to find where the problem lies with a particular issue (regardless of your skill level, information is always helpful)
  • Fixing issues, if you spot an issue you think you can fix, please make a fork and submit a pull request that solves the issue. Any contributions are welcome!
    • Right now we don't have a very fixed code styling due to the amount of inconsistency in the project. At some point I'm going to go through and make it all consistent, but it'll probably be CamelCase or a slight variation of it that'll be used.

Donations

If you want to help this project rapidly grow, you can donate via PayPal to help further develop Aurora. While being a university student, Aurora does not take my monetary priority. Games and RGB hardware are not cheap, and as a result, support for not owned products will take more time to develop. The donations will be used to purchase hardware and video games with intent to add support for them with Aurora. Alternatively you can gift games directly to me via Steam.

I do not have any intent in charging money for Aurora, it will always be a free and open source project.

PayPal Steam

Credits

Special thanks to these people:

Contributions

Thanks to all the brilliant people that made contributions to this project. See everyone here

Testing

  • Casper
  • dirty_thomas
  • Dustmuffins
  • eMJay
  • FarmeZZ
  • Firewall
  • LASTBULLET_ZEROALIAS
  • KensonN
  • Melantrix
  • Mice
  • NurisH
  • Podgy
  • Raushen
  • Steven-O-kun
  • System Overlord
  • Tatsuto
  • ThirdEyeOpen
  • Trickster79
  • twitch.tv/fearsc | Faceit.com
  • Warblade