• Stars
    star
    1,772
  • Rank 26,271 (Top 0.6 %)
  • Language
    Python
  • License
    GNU Lesser Genera...
  • Created almost 11 years ago
  • Updated almost 5 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Beautiful Linux System https://meilix.org | APT Repo: http://meilix.fossasia.org

Meilix

A beautiful and customizable Linux build for out of the box features for an Internet Kiosk. 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.


Join the chat at https://gitter.im/fossasia/meilix Build Status

Meilix is under heavy development. It is in alpha stage and not yet recommended for productive use.

Index

  1. Introduction
    1. Features
    2. Architecture
    3. Ecosystem
  2. Usage
  3. Pre Requisites
  4. Development
    1. File Structure
    2. Build
    3. Metapackages
    4. Testing
  5. Contribution
    1. Community
    2. Guideline
    3. Branches
    4. Best Practice
  6. Resource
  7. Gallery
  8. License

Introduction

This project serves as a solution for those who wish to have a pre-configured custom Linux, with all the needed apps/features already installed. An example of its use case is events. Every event organizer needs to have all their systems configured equally, and need some specific apps to run the event. Configuring each system one by one can be a time taking and difficult task, but using Meilix, they can create their own custom Linux ISO and run/live boot on as many systems as they want. It will not just save countless hours, but also make the process more cost-efficient.

Feature

Meilix is a light weight, beautiful and fast Linux with all the features of Ubuntu/Debian distro. Custom Meilix builds are commissioned by the Meilix-generator web app.

Architecture

Meilix is based on Ubuntu/Debian architecture. Meilix uses LXQT as the standard Desktop Environment.

Ecosystem

Following are the other projects/dependency part of Meilix ecosystem.

Name About
Meilix This repo for standalone build or as a backend for the webapp
Meilix-generator A webapp which generates an ISO Image of Meilix Linux
Meilix-systemlock A program to freeze the system
Meilix-artwork Boot screen splash themes for Meilix

Usage

To create your own Linux for an event kiosk or just for trying it out, you can use Meilix-generator. A web app, which has all the options to customize and generate an ISO.

Pre Requisites

Here are some pre-requisites to develop Meilix.

  • Exposure to the terminal and basic commands and basic comprehension of shell scripts
  • Experience in working with a Debian system.
  • LPIC1 is a huge plus

Development

Meilix fetches ubuntu source, customizes it to add features and then builds the distro. It uses shell scripts to perform all the tasks, build can be made on local machine or via Travis CI.

File Structure

Basic understanding of the file structure is required to do development, here is a level 2 file structure of this project

.
โ”œโ”€โ”€ build.sh
โ”œโ”€โ”€ LICENSE.md
โ”œโ”€โ”€ sources.xenial.list
โ”œโ”€โ”€ sources.bionic.list
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ systemlock_0.1-1_all.deb
โ”œโ”€โ”€ image-amd64.tar.lzma
โ”œโ”€โ”€ image-i386.tar.lzma
โ”œโ”€โ”€ ubiquity-slideshow
|   โ””โ”€โ”€ slides/...
โ”œโ”€โ”€ polkit-1
โ”‚ย ย  โ””โ”€โ”€ actions/...
โ”œโ”€โ”€ conf
โ”‚ย ย  โ””โ”€โ”€ distributions/...
โ”œโ”€โ”€ pool
โ”‚ย ย  โ””โ”€โ”€ main/...
โ”œโ”€โ”€ systemlock-0.1
โ”‚ย ย  โ”œโ”€โ”€ debian/...
โ”‚ย ย  โ”œโ”€โ”€ etc/...
โ”‚ย ย  โ”œโ”€โ”€ Makefile/...
โ”‚ย ย  โ””โ”€โ”€ usr/...
โ”œโ”€โ”€ meilix-default-settings
โ”‚ย ย  โ”œโ”€โ”€ debian/...
โ”‚ย ย  โ”œโ”€โ”€ etc/...
โ”‚ย ย  โ”œโ”€โ”€ Makefile/...
โ”‚ย ย  โ””โ”€โ”€ usr/...
โ”œโ”€โ”€ scripts
โ”‚ย ย  โ”œโ”€โ”€ aptRepoUpdater.sh
โ”‚ย ย  โ”œโ”€โ”€ arch.sh
โ”‚ย ย  โ”œโ”€โ”€ browser_uri.sh
โ”‚ย ย  โ”œโ”€โ”€ chroot.sh
โ”‚ย ย  โ”œโ”€โ”€ debuild.sh
โ”‚ย ย  โ”œโ”€โ”€ legacy_initrdext.sh
โ”‚ย ย  โ”œโ”€โ”€ mail-fail.py
โ”‚ย ย  โ”œโ”€โ”€ mail.py
โ”‚ย ย  โ”œโ”€โ”€ meilix_check.sh
โ”‚ย ย  โ”œโ”€โ”€ mew.sh
โ”‚ย ย  โ”œโ”€โ”€ packages
โ”‚ย ย  โ””โ”€โ”€ releases_maintainer.sh
โ””โ”€โ”€chroot
 ย ย  โ”œโ”€โ”€ bin/...
 ย ย  โ”œโ”€โ”€ boot/...
 ย ย  โ”œโ”€โ”€ dev/...
 ย ย  โ”œโ”€โ”€ etc/...
 ย ย  โ”œโ”€โ”€ home/...
 ย ย  โ”œโ”€โ”€ lib/...
 ย ย  โ”œโ”€โ”€ lib64/...
 ย ย  โ”œโ”€โ”€ media/...
 ย ย  โ”œโ”€โ”€ mnt/...
 ย ย  โ”œโ”€โ”€ opt/...
 ย ย  โ”œโ”€โ”€ proc/...
 ย ย  โ”œโ”€โ”€ root/...
 ย ย  โ”œโ”€โ”€ run/...
 ย ย  โ”œโ”€โ”€ sbin/...
 ย ย  โ”œโ”€โ”€ srv/...
 ย ย  โ”œโ”€โ”€ sys/...
 ย ย  โ”œโ”€โ”€ tmp/...
 ย ย  โ”œโ”€โ”€ usr/...
 ย ย  โ””โ”€โ”€ var/...

Build

Building Locally

  1. Make the build script executable.
$ chmod +x ./build.sh
  1. Execute the script.
$ ./build.sh

Testing the ISOs

  1. Local Installation with Qemu/KVM
  2. Run as a live CD in Virtualbox by Oracle

Build Using Travis*

  1. Update .travis.yml according to your API key as explained here
  2. Push changes to your repo, it will start the build process.

Contribution

Your code contributions are always appreciated. To keep your experience good, we suggest you read all the guidelines thoroughly, also take some time to understand the workflow for this project. Each contribution is expected to follow best practices and community guidelines. Following are the things you can do to contribute to Meilix

  1. Report a bug
    If you think you have encountered a bug, and we should know about it, feel free to report it here and our community will take care of it.

  2. Request a feature
    You can also request for a feature here, and if the community feels it's viable, it will be picked for development.

  3. Create a pull request
    It can't get better then this, your pull request will be really appreciated by the community. You can get started by picking up any open issues from here and make a pull request.

Community

Meilix has contributors around the world, constantly improving Meilix and helping others as well to do so. To get in touch with the community, you can use the following communication channels.

Gitter: https://gitter.im/fossasia/meilix
Mailing List: https://groups.google.com/forum/#!forum/meilix
Scrum Mail: [email protected]
Twitter: https://twitter.com/meilix_

Guideline

FOSSASIA Open Source Guidelines can be found here

Branches

Meilix uses an agile continuous integration methodology, so the version is frequently updated and development is really fast.

  1. Master is the development branch. It should always built.

  2. Generator is a legacy branch we keep for reference for the time being. It chrooted a master branch ISO release and made changes as requested by the meilix-generator app and repackaged the customized ISO.

  3. No further branches should be created in the main repository.

Steps to create a pull request

  1. Make a PR to master branch.
  2. Comply with the best practices and guidelines e.g. where the PR concerns visual elements it should have an image showing the effect.
  3. It must pass all continuous integration checks and get positive reviews.

After this, changes will be merged.

Best Practice

Commits

  • Each commit should have proper documentation and comments in code, which will make it easy for others to understand it.
  • Make sure your commit message is crisp and clear, read more about it here
  • When refering to a issue in a Pull Request, use special words to automatically close the related issue like "Fixes #234"
  • Keep each PR limited in scope, which will make it easy to review and correct. Squash your commits.

Resource

License

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

More Repositories

1

visdom

A flexible tool for creating, organizing, and sharing visualizations of live, rich data. Supports Torch and Numpy.
Python
10,012
star
2

open-event-server

The Open Event Organizer Server to Manage Events https://test-api.eventyay.com
Python
2,906
star
3

phimpme-android

Phimp.me Photo Imaging and Picture Editor https://play.google.com/store/apps/details?id=org.fossasia.phimpme
Java
2,576
star
4

susi_server

SUSI.AI server backend - the Artificial Intelligence server for personal assistants https://susi.ai
Java
2,503
star
5

susi_android

SUSI.AI Android App https://play.google.com/apps/testing/ai.susi
Kotlin
2,419
star
6

open-event-frontend

The frontend for the Open Event API Server https://test.eventyay.com
JavaScript
2,335
star
7

open-event-droidgen

Open Event Android App Generator https://github.com/fossasia/open-event-android/raw/apk/sample-apk-fossasia17-development.apk
Java
2,048
star
8

pslab-android

PSLab Android App https://play.google.com/store/apps/details?id=io.pslab
Java
2,046
star
9

susi.ai

SUSI.AI Web Client https://susi.ai
JavaScript
2,033
star
10

open-event-wsgen

Open Event Website App Generator https://sched.eventyay.com
JavaScript
2,013
star
11

open-event-attendee-android

Open Event Attendee Android General App https://github.com/fossasia/open-event-android/blob/apk/open-event-dev-app-playStore-debug.apk
Kotlin
1,947
star
12

star-me

Star FOSSASIA Repositories on Github and Support the Community
JavaScript
1,905
star
13

fossasia.org

FOSSASIA Website https://fossasia.org
Less
1,883
star
14

susi_iOS

SUSI AI iOS app http://susi.ai
Swift
1,869
star
15

loklak_search

Frontend Search for loklak server https://loklak.org
TypeScript
1,831
star
16

badgemagic-android

Badge Magic with LEDs - Android App https://play.google.com/apps/testing/org.fossasia.badgemagic
Dart
1,828
star
17

badgeyay

Attendee Badge Generator for Conferences
JavaScript
1,787
star
18

open-event-organizer-android

Open Event Mobile App for Organizers and Entry Managers https://play.google.com/store/apps/details?id=com.eventyay.organizer
Java
1,784
star
19

pslab-desktop

PSLab Desktop Application https://pslab.io
JavaScript
1,763
star
20

susper.com

Susper Decentralised Search Engine https://susper.com
TypeScript
1,734
star
21

open-event

Open Event Project, Samples, Documentation and Artwork http://open-event-dev.herokuapp.com
Python
1,701
star
22

neurolab-android

NeuroLab Android https://github.com/fossasia/neurolab-android/raw/apk/neurolab-dev-debug.apk
Java
1,700
star
23

labs.fossasia.org

Projects Website for FOSSASIA http://labs.fossasia.org
CSS
1,669
star
24

query-server

Query Server Search Engines
Python
1,659
star
25

gci16.fossasia.org

FOSSASIA Google Code-In Website 2016/17 http://gci16.fossasia.org
HTML
1,652
star
26

pslab-hardware

PSLab Hardware Design and Schematics https://pslab.io
Prolog
1,642
star
27

codeheat.org

Codeheat Coding Contest Website https://codeheat.org
Less
1,628
star
28

pslab-python

Python Library for PSLab Desktop: https://pslab.io
Python
1,624
star
29

pslab-scripts

Pocket Science Lab - Scripts for Sensor Experiments
Python
1,604
star
30

susi_linux

Hardware for SUSI AI https://susi.ai
Python
1,604
star
31

flappy-svg

Flappy Bird in SVG. Play it at http://fossasia.github.io/flappy-svg/
JavaScript
1,604
star
32

gci17.fossasia.org

FOSSASIA Google Code-In Website 2017/18 https://gci17.fossasia.org
CSS
1,598
star
33

gci15.fossasia.org

FOSSASIA Google Code-In Website 2015/16 http://gci15.fossasia.org
HTML
1,596
star
34

2017.fossasia.org

FOSSASIA Summit 2017 https://2017.fossasia.org
HTML
1,580
star
35

2018.fossasia.org

FOSSASIA Summit 2018 https://2018.fossasia.org
HTML
1,577
star
36

fossasia-communities

FOSSASIA API Files of Communities in Asia
1,576
star
37

susi_skill_cms

A web application framework to edit susi skills http://skills.susi.ai
JavaScript
1,572
star
38

open-event-attendee-ios

iOS app for open event
Swift
1,570
star
39

gci14.fossasia.org

FOSSASIA Google Code-In Website 2014/15 http://gci14.fossasia.org
JavaScript
1,569
star
40

2016.fossasia.org

FOSSASIA Summit 2016 https://2016.fossasia.org
CSS
1,564
star
41

2012.fossasia.org

FOSSASIA Summit 2012 Event Site https://2012.fossasia.org
CSS
1,563
star
42

knittingpattern

A Python Library for Knitting Patterns
Python
1,562
star
43

loklak_webclient

loklak web application
JavaScript
1,553
star
44

pslab-firmware

Firmware for PSLab Open Hardware Platform https://pslab.io
C
1,550
star
45

loklak_wok_android

"loklak wok" is a harvesting peer for the loklak_server https://github.com/fossasia/loklak_wok_android/raw/apk/loklak_wok_1.2_20160201.apk
Java
1,549
star
46

directory.api.fossasia.net

Python
1,547
star
47

neurolab-hardware

Neurolab Hardware
1,541
star
48

yaydoc

Docs! Yay! http://yaydoc.org
JavaScript
1,540
star
49

2015.fossasia.org

FOSSASIA Summit 2015 Event Site https://2015.fossasia.org
CSS
1,539
star
50

susi_chromebot

SUSI.AI Chrome Extension
JavaScript
1,538
star
51

meilix-systemlock

Meilix system lock
Python
1,537
star
52

2014.fossasia.org

FOSSASIA Summit 2014 Event Site http://2014.fossasia.org
HTML
1,537
star
53

x-mario

x-mario, the gaming distro
Shell
1,534
star
54

phimpme-drupal

Phimp.me - Photo App on Drupal
PHP
1,534
star
55

knitlib

Knitting backend library for knitting machines
Python
1,532
star
56

yaydoc-artwork

Open Source Books
1,532
star
57

phimpme-wordpress

Phimp.me - Photo App on Wordpress
PHP
1,532
star
58

sg18.sciencehack.asia

UNESCO Hackathon Website at the FOSSASIA Summit Singapore https://sg18.sciencehack.asia
CSS
1,532
star
59

searss

Search to RSS tool
Python
1,531
star
60

CommonsNet

Sharing and Transparency for WiFi Networks
JavaScript
1,531
star
61

knitweb

knitting web app frontend and backend
JavaScript
1,530
star
62

meilix-generator

WebApp for generating a custom ISO image based on Meilix http://meilix.org
HTML
1,530
star
63

pslab-case

PSLab Case https://pslab.io
1,530
star
64

fossasia.net

FOSSASIA.net Website https://fossasia.net
HTML
1,530
star
65

2011.fossasia.org

FOSSASIA Summit 2011 Event Site http://2011.fossasia.org
HTML
1,530
star
66

unesco.sciencehack.asia

UNESCO Hackathon Website https://unesco.sciencehack.asia
CSS
1,530
star
67

pslab-expeyes

PSLab for ExpEYES - Science Experiments and Data Acquisition for Physics Education https://pslab.io
Python
1,529
star
68

api.fossasia.net

FOSSASIA API
JavaScript
1,529
star
69

xmario_buildscript

x-mario build script
Shell
1,529
star
70

fossasia-nodemailer

JavaScript
1,529
star
71

2023.fossasia.org

HTML
1,528
star
72

hotelxoai.com

The Open Source Hotel in the Mekong Delta in Vietnam
HTML
1,527
star
73

2010.fossasia.org

FOSSASIA Summit 2010 Event Site http://2010.fossasia.org
HTML
1,527
star
74

fossasia11-drupal

FOSSASIA 2011 Drupal Site
PHP
1,526
star
75

blog.fossasia.org

Issue Tracker for https://blog.fossasia.org
1,526
star
76

susi_smart_box

SUSI.AI Smart Box https://susi.ai
1,526
star
77

fossasia10-drupal

FOSSASIA 2010 Drupal Site
PHP
1,525
star
78

perspektive89.com

Open Source Journal Perspektive89.com
1,525
star
79

cmap.api.fossasia.net

FOSSASIA Community Map
JavaScript
1,523
star
80

feed.api.fossasia.net

PHP
1,522
star
81

loklak-webtweets

FOSSASIA Tweets with loklak http://fossasia.github.io/loklak-webtweets/
Less
1,522
star
82

foss.vn

FOSS.vn Website http://foss.vn
HTML
1,522
star
83

labyrinth

FOSSASIA Labyrinth
JavaScript
1,519
star
84

pslab-test-jig

PSLab Test Jig - Boards to test PSLab hardware https://pslab.io
1,518
star
85

jugaadfest.com

Jugaadfest in India https://jugaadfest.com
HTML
1,518
star
86

knitpat

Knitting Pattern Format
Python
1,518
star
87

susi_tweetbot

Twitter Bot for Susi http://susi.ai
JavaScript
1,517
star
88

open-event-scraper

Google spreadsheet parsing for Open Event JSON
Python
1,516
star
89

fossasia.github.io

FOSSASIA.GitHub.io
HTML
1,516
star
90

knitserver

JavaScript
1,515
star
91

open-event-next

Open Event Frontend "Next Version" with Vue.js
TypeScript
1,515
star
92

susi_skill_data

A storage place for SUSI.AI skills https://susi.ai
1,514
star
93

loklak_tweetheatmap

Heat map with tweets by search query using Loklak API and OpenLayers 3
JavaScript
1,513
star
94

sciencehack.asia

Science Hack Website http://sciencehack.asia
CSS
1,512
star
95

fossasia-artwork

Artwork related to FOSSASIA
1,512
star
96

susi_telegrambot

Susi Telegram Bot http://susi.ai
JavaScript
1,511
star
97

timeline.api.fossasia.net

JavaScript
1,511
star
98

susi_fbbot

Susi Facebook Bot http://susi.ai
JavaScript
1,510
star
99

susi_slackbot

Ask Susi Messengers http://susi.ai
JavaScript
1,510
star
100

kniteditor

Kniteditor
Inno Setup
1,509
star