Skip to content

Latest commit

 

History

History
293 lines (216 loc) · 13.4 KB

README.md

File metadata and controls

293 lines (216 loc) · 13.4 KB

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)

How to Install

  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 2015 and Microsoft .NET Framework 4.5 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.

Run this program in the background at windows start

You can set Aurora to run on Windows Startup. Go into Settings and check "Start with Windows". Aurora Settings

Natively Supported Games

  • Dota 2
  • CS:GO
  • Grand Theft Auto V
  • Rocket League
  • Overwatch
  • Payday 2
  • The Division
  • League of Legends
  • Hotline Miami
  • The Talos Principle
  • Battlefield 3
  • Blacklight: Retribution
  • Magic: The Gathering - Duels of the Planeswalkers 2012
  • Middle-earth: Shadow of Mordor
  • Serious Sam 3
  • Robot Roller-Derby Disco Dodgeball
  • XCOM: Enemy Unknown
  • Evolve Stage 2
  • Metro: Last Light
  • Guild Wars 2
  • Worms W.M.D
  • Blade and Soul
  • Borderlands 2

Natively Supported Devices

  • Logitech
  • Corsair
  • Razer
  • Clevo
  • Cooler Master
  • AtmoOrb
  • SteelSeries devices

Video demonstrations

Dota 2 Demo

Dota 2 Demo

Rocket League Demo

Rocket League Demo

Grand Theft Auto V Demo

Grand Theft Auto V Demo

Robot Roller-Derby Disco Dodgeball Demo

Robot Roller-Derby Disco Dodgeball Demo

Screenshots

Desktop Settings Dota 2 Settings CSGO Settings GTA 5 Settings Rocket League Settings Payday 2 Settings Skype Integration Settings

In-depth features

General

  • Support for per-key Logitech devices
  • Support for Razer Chroma devices
  • Support for per-key Corsair devices
  • Support for Cooler Master devices
  • Support for Clevo devices
  • Support for AtmoOrb
  • Support for popular online games: Dota 2, CS:GO, GTA 5, Rocket League, and Overwatch
  • 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

Dota 2 features

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

CS:GO features

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

Grand Theft Auto V features

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

Rocket League features

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

Overwatch features

  • Overwatch effects are controlled by the game itself

Payday 2 features

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

The Division features

  • The Division effects are controlled by the game itself

League of Legends features

  • League of Legends reacts to player HP, when damaged, healed, or killed.

Hotline Miami features

  • Hotline Miami has a slowly alternating color effect.

The Talos Principle features

  • The Talos Principle changes color based on the puzzle color you are in.

Borderlands 2 features

  • Health and Shield 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.

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 "Aurora Location/logs" directory.

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

You can report bugs here, by creating a new Issue here.

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

If you want to donate using crypto then here are some options:

Bitcoin: 1A4d9mdRTW5gtmnG4FG8Q1RYZGzPRuvNm4

Ethereum: 0xe54F36b8a429b531483f3C18799fcE01E70BF9c3

Litecoin: LiLnCr2FQCwExmL3vBSkWCqZuv63hP3N2v

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