Skip to content
WebApp for generating a custom ISO image based on Meilix
Branch: master
Clone or download
pranav1698 and tabesin Adding option for dark and light theme for the meilix ISO - (Solves -#…
…431) (#432)

* Adding option for dark and light theme

* Solves toggle not matching error
Latest commit 09fcf76 Mar 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update (#349) Nov 22, 2018
.vscode Solved unbound-variable error Feb 17, 2019
docs Added documentation for managing heroku config vars - (Solves- #402) (#… Feb 18, 2019
Procfile Corrected my_token link Jan 7, 2019
app.json Update app.json Oct 2, 2018 This sends the theme to the build server (#433) Mar 22, 2019 This sends the theme to the build server (#433) Mar 22, 2019
manifest.yml This solves automatic deployment for surge - (Solves- #375) (#376) Jan 19, 2019
requirements.txt Travis trigger script in python added - (Solves- #124) (#396) Feb 11, 2019
runtime.txt fixes #91 (#343) Nov 11, 2018

Meilix Generator

A Webapp to generate customized iso live images of Meilix Linux. You can use the Meilix Generator (Web app) to make a Linux for your own brand/event, also add apps and features you need pre-installed, it will create an ISO Image of your Linux, which you can use as a live boot or install on PCs.

GSoC 2017 Travis branch Gemnasium Heroku Code Climate codecov Codacy branch grade Gitter Reviewed by Hound

Gitter channel

Table of Contents

Meilix Generator Features

Following are some of the other features that Meilix-Generator offers:

  • You can brand your Linux as you want. Your company name and logo can be your:

    • Linux name
    • Linux logo
    • Wallpaper
    • Screensaver
  • Switch on/off various features of your linux. You can switch:

    • 64 Bit support (or legacy 32 Bit)
    • Notifications
    • Screensaver
    • Sleep Modes
    • System Sounds
    • Bookmarks
    • Screen Dimming
    • Power Management Saving
    • Taskbar Autohide
  • Following apps can be pre-installed in your linux:

    • Chromium
    • Firefox
    • Hangout
    • VLC
    • GIMP
    • Inkscape
    • LibreOffice
    • Git
    • NextCloud
    • Dropbox
  • Add all the documents and files you need in your linux.

  • System Lock: it allows you to freeze all the systems you are hosting using Meilix.

Meilix-Generator components

  • fossasia/meilix hosts and builds the source files of Meilix Linux.
  • The bootscreen is build as a deb package in fossasia/meilix-artwork.
  • This webapp is used to trigger a Meilix build based on the user configuration. Builds are run on Travis and the user is mailed a link download the custom build. Builds are released to Github releases.
  • Meilix Generator follows the standard front end of other FOSSASIA projects like Open Event Webapp

Under the hood



The webapp rests in 2 templates, served by Flask:


The generator runs on Flask, routes contained in main app script

  • The route / renders the index.html which is used to
  • /output route triggers the build on Meilix and renders the build.html


/output route runs the which in turn sends a curl request to Travis to trigger a build a Meilix repo. The request is sent with a JSON payload which contains information like which packages to pre-install, homepage URL, browser choice, build architechture, etc.

travis_tokens has configuration required by Travis, it specifies on which branch to trigger build on.

Work flow

Webapp is hosted at Required configuration is obtained from the form and the user triggers the build. When the build is complete on the Meilix repo, the user is mailed with the link to download the iso image. Look at and .travis.yml on the Meilix repo for insight on the actual build process.

Build Customize


The meilix-generator can be easily deployed onto a variety of platforms. Platform specific installation instructions have been provided below:

  1. Local installation
  2. Deployment to Heroku
  3. Docker container


This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests, submitting pull requests as well. Please report issues here

Note: Make sure to fork both meilix and meilix-generator and to use your own token. Refer to for details.

Issues and Branch policy

Before making a pull request, please file an issue. So other developers will have a chance to give feedback or discuss upon. Match every pull request with an issue please and add the issue number in description e.g. like Fixes #123.

Go for only one issue per pull request

We have the following branches

  • master All development goes on in the master branch. If you're making a contribution, you are supposed to make a pull request to master. PRs to the branch must pass a build check and a unit-test check on Travis. They are usually reviewed by at least two team members.

Best practices

Write-up containing project buildup


This project is currently licensed under GNU Lesser General Public License v3.0 (LGPL-3.0). A copy of should be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.

If you like the project, don't forget to star it.

You can’t perform that action at this time.