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.
A couple of files need changing to get the site working for you.
config/config.yaml.distand rename it to
config.yaml. Fill in the fields according to their descriptions and save.
sourire_serviceyou'll want to point it to your local Sourire server. For example
- Create a file at
templates/_analytics.txtfor 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:
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:
This will install Bower which will allow you to install the assets the website requires (Bootstrap, jQuery etc.) 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.