Skip to content
Branch: master
Go to file

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time


Worship your favorite molecule by setting it as your wallpaper.

Avogadrio is a web app that will render your favourite molecule as a desktop wallpaper from either a compund name or SMILES structure. Molecule rendering is designed to be powered by Sourire which itself wraps the Indigo cheminformatics toolkit. Built on the Silex micro-framework.



You'll need to have a web server installed and configured with PHP for this to work. I really recommend XAMPP, especially for Windows users. Once you've done that you can proceed.

You'll also need Node.js and npm installed and working.


A couple of files need changing to get the site working for you.

  1. Copy config/config.yaml.dist and rename it to config.yaml. Fill in the fields according to their descriptions and save.
  2. For sourire_service you'll want to point it to your local Sourire server. For example http://localhost:8080/.
  3. Create a file at templates/_analytics.txt for your analytics code. Leave it blank if you like, but you must create it.


Clone the project down and open the folder in your favourite editor. It's a JetBrains PhpStorm project but you can use whichever paid/free software takes your fancy.

Before anything else, note that this project uses the Composer package manager. Install composer (see their website) and run:

composer install

Or alternatively, if you're using the PHAR (make sure the php.exe executable is in your PATH):

php composer.phar install

Then, install the npm packages necessary to build and run the website. Run the following in your terminal in the project root directory:

npm install

This will install Bower which will allow you to install the assets the website requires (Bootstrap, jQuery etc.) using the command:

bower install

Gulp will also have been installed. This will compile the Less and CoffeeScript into CSS and JavaScript ready for production. Do this using the command:


This command will need running again every time you make a change to a Less or CoffeeScript file. If you're working on them, run gulp watch in a terminal to watch for file changes and compile accordingly.


A big thank you to:

  • Nile Red inspired me to build this. I wasn't that big on chemistry until I came across his videos.
  • Jay Holtslander put together the hamburger menu/sidebar combo in his Pen on CodePen. I believe it's derived from earlier work by maridlcrmn.
  • Thomas Moerman created Sourire, which really simplified the molecule rendering process.
  • Andre Plötze created pure-knob, which is used here for the rotation knob/wheel/dial thing.


Worship your favorite molecule by setting it as your wallpaper.





No releases published
You can’t perform that action at this time.