Beautiful Linux System http://meilix.fossasia.org
Python Shell JavaScript HTML Makefile
Switch branches/tags
untagged-fc3b4e57fb78913ae8cf untagged-fbfc7c9d1fcb6b85664b untagged-f7672a8e7630a57fc7dd untagged-f991eeb8479a39a97f46 untagged-f891c7dc3c5229795410 untagged-f24c71a9f413aac14379 untagged-f8d86089a0cff6b365bc untagged-f6ba3f0efc76f0fbade1 untagged-f4ff58f869469d4fa019 untagged-f4efa58b22090aa15d28 untagged-f0bb56ae5a3a6aac585c untagged-ef2fd636a53f4d0268cb untagged-ef1db0730718e3c5b409 untagged-ec090eade53280435857 untagged-ec5d66b7f32c7c84ea2f untagged-eb1b481e94929155ecfb untagged-ea562913b05eaca76de8 untagged-ea0057e1c78fca0671a9 untagged-e337428be18400673be6 untagged-e59618dc3d4f847ef64d untagged-e971d8c8d321c8020b37 untagged-e42c17ffe32fc212fe2e untagged-e7b8d273fb43b0b5d4ba untagged-e6f7440d0ea02f69d730 untagged-e0eebfe62ffe70dc46b1 untagged-dfc392f811217ca080f0 untagged-ddff9871d6ce64f8015f untagged-dc118f785f3aef3f1931 untagged-d901ad5a3eb2764d9dba untagged-d45b1ff44344c76bdc66 untagged-d9e4bdae2b17afffec33 untagged-d9bde4d558f366501fdb untagged-d06c4c0c7336ed1a5627 untagged-d6bb204ca358e66ddc21 untagged-d5e2c6c033f70d784daa untagged-d2d24a29d354b9584184 untagged-d2c3d7386a7077f069cc untagged-d0c6dd4e745866e2b8cd untagged-ceb371622255d900d746 untagged-cb7a0718b4ede25c8e41 untagged-ca738f17e2452ba2436b untagged-ca89ee0bb180bc6f6e19 untagged-c34172d14485d4562c5d untagged-c01252f230aa24c67d6c untagged-c924a69d12debe9b87e9 untagged-c383f82456d7ae13dc61 untagged-c9f68d2fa6b3d1cdbd99 untagged-c9c3672250b05fb2a368 untagged-c4ce5b88cf4c1f231995 untagged-c09465312927ca1df566 untagged-bfd6b432bb3d4b54104a untagged-bf7629974943c1a0dd2c untagged-bf632899bb44694fdcba untagged-bdf599bdde341689833e untagged-bd1005bc8c0941c5aa1f untagged-b702ca2caaec21ef49c4 untagged-b055ca44be9c84a5e832 untagged-b6ca7922991615282af1 untagged-b0bdd5c9b37fdcb4b158 untagged-af382b42357413ae502c untagged-aca74f8d626437a972ac untagged-ab1f7d5ecc590a802820 untagged-aad16586181ef7a87499 untagged-aa826effb032f92d11d7 untagged-a94f8fba43f289a7a700 untagged-a076db9c40f6c1e1d223 untagged-a76a08e81676508b9ef0 untagged-a30a37a6245b1fbae801 untagged-a9c41e36617cc36980fb untagged-a6a33b65e9e332b99068 untagged-a1fbdd1b9d2c9367034a untagged-58270162303a4435efb7 untagged-0910134618cd496e35c5 untagged-94175521fba84cfbf0ea untagged-2334561c565ed80990a6 untagged-916180aa4894994b155c untagged-798935a935a09883dbce untagged-502724cac47061a9c6ef untagged-279789cb86e28e1c0249 untagged-85976ba9b9442e6d0e3c untagged-83860a0a79121f96b365 untagged-78575de7f5a30d3cd47b untagged-68874ccd56fa98cc639c untagged-61795d2bfb92e1c672f5 untagged-60475d519c62c6bc0c2f untagged-47926c1ccbcdf691120b untagged-10858c022d583d924224 untagged-9587c97b59c85186201c untagged-9403abae58a682f78f2e untagged-8878ade696a4063ece4a untagged-8289d7c53ff53f03d5f3 untagged-8088b9d40c390764dcc6 untagged-6486e79adde9f7183572 untagged-6341d78415c12fa04860 untagged-6219b4326c76f81bf4b6 untagged-4460cf817d209087a54f untagged-4338c1734ac48307117b untagged-1764b5c1c63425211e04 untagged-966b48f37ac955b86f69 untagged-945a555932e1e31982ff
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Update CONTRIBUTING.md Jan 3, 2018
conf Making Travis to auto apply the souces to gh-pages Dec 27, 2016
db Added metapackages and improved readme (#38) Apr 20, 2017
dists/trusty Added metapackages and improved readme (#38) Apr 20, 2017
image Delete autorun.inf Aug 8, 2018
mail-scripts rectified error in URL of time May 19, 2018
meilix-artwork removed gksu dependency Aug 20, 2017
meilix-default-settings Delete autologin.conf Aug 15, 2018
meilix-metapackages_1.0_all added meta-packages (#36) Apr 18, 2017
metapackage/debian new structure and new build Sep 28, 2014
polkit-1/actions first commit Dec 27, 2013
pool/main Added metapackages and improved readme (#38) Apr 20, 2017
scripts Update chroot.sh Aug 19, 2018
systemlock-0.1 new structure and new build Sep 28, 2014
ubiquity-slideshow/slides Adds ubiquity for hard disk installation Dec 18, 2017
.gitignore added mailing script May 15, 2018
.travis.yml Update .travis.yml Jul 28, 2018
LICENSE.md Added license Dec 31, 2016
README.md Update README.md Aug 7, 2018
build.sh Update build.sh Aug 12, 2018
image-amd64.tar.lzma Add Image of 64bit version Jul 13, 2018
image-i386.tar.lzma juliens magie Sep 28, 2014
meilix-metapackage_1.0-1.dsc new structure and new build Sep 28, 2014
meilix-metapackage_1.0-1.tar.gz new structure and new build Sep 28, 2014
meilix-metapackage_1.0-1_all.deb new structure and new build Sep 28, 2014
meilix-metapackage_1.0-1_amd64.changes new structure and new build Sep 28, 2014
meilix-metapackages_1.0_all.deb added meta-packages (#36) Apr 18, 2017
plymouth-meilix-logo_1.0-1_all.deb ubuntu 16.04 onwards dont use /lib for plymouth Aug 20, 2017
plymouth-meilix-text_1.0-1_all.deb ubuntu 16.04 onwards dont use /lib for plymouth Aug 20, 2017
sources.list Update sources.list Aug 13, 2018
systemlock_0.1-1_all.deb new structure and new build Sep 28, 2014

README.md

Meilix

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

Beautiful Linux Build Distro

  • LXQT as the standard Desktop Environment
  • based on ubuntu/debian architecture
  • Philosophy: light weight, fast, customized
  • Reasonable preconfigured settings for the use case
  • system lock

Feature

  • Meilix uses build.sh to build the Distro.
  • build.sh is a shell script which fetch ubuntu sources and customizes it to get the required distro.
  • chroot.sh installs the required packages and metapackges.
  • debuild.sh is used to rebuild the metapackages in case of a change in the meilix-metapackage.

Starting Development

Building Locally

  • You need to run ./build.sh in your terminal to get an iso locally in your system.

Building on Travis

  • After forking the repo make required changes.
  • Change the .travis.yml API key by following the article
  • Now as soon as you push the required changes in your branch of forked repo, Travis will make a Github Release.
  • The build ISO file could be tried out with virtual machines as qemu or virtualbox to test your changes.
  • Remember before making a PR, make sure all your changes work, refer to the related issue. The issue should get closed and revert back the Travis API key to that of FOSSASIA since that key will be responsible for building the ISO.
  • Squash your commits if there are more than one.

Creating a metapackage

Creating a metapackage is really easy, we will make use of equivs to make our metapackage.

  • First, install equivs: sudo apt-get install equivs
  • Now run equivs: equivs-control ns-control
  • It will create a file called ns-control, open this file with your text editor.
  • Modify the file to your needs modifying the needy information.
  • Then run: equivs-build ns-control to build your metapackage, thats all simple and easy.
  • To add it to meilix follow adding a metapackage to meilix section.

List of basic items included while creating a metapackage

  • Changes will be made in the ns-control file which was created earlier.
  • Change the name of the ns-control file to control.
  • There are several lines of which required one are mention below:
  • Source and package is the name of the metapackage that we want to give.
  • Depends line consists of the packages that we want the metapackage should consistes of.
  • Description line consists a short description of the metapackages.
  • There are lots of other line which also matters depending upon the need of the metapackage. Go through here for more info.

Adding a Metapackage to meilix

  • Create a metapackage and place it in the root directory of the project
  • Add it to the build.sh file like sudo cp -v nameOfYourMeta-package.deb chroot in the 'copy source.list' line and dpkg -i nameOfYourMeta-package.deb lastly apt-get install -f.
  • Follow the syntax (writing style) used in the build.sh
  • Install reprepro if you don't have it, run: sudo apt-get install reprepro
  • Make sure you are on the meilix repository.
  • Run the following command for each meta-package you create: reprepro includedeb trusty ./nameOfYourMeta-package.deb

Personalizing it

Updating the OS/metapackage to the latest version

  • For this, we need to update sources.list file to the version we desire.

Customize the Browser

  • For this, we need to edit chrome.json file found under meilix-default-settings. You can change homepage URL, default search-engine,etc. If you want to change some setting which is selected by default, then remove the comment and change its value from "1" to "0" or from "false" to "true" or vice-versa, depending upon the requirement.

Know your OS

  • Metapackage and distro information can be found in dists directory.

Communication

Chat: Gitter Channel | Get an Invite Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/meilix Scrum report for the repository will be send to the address: meilix@googlegroups.com

Contributions, Bug Reports, Feature Requests

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 in the GitHub tracker.

Branch Policy

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
  • gh-pages This contains the autogenerated code of the master branch that is generated by Travis.
  • generator This (obsolete) branch was responsible for having the changes which will be implemented for generating the iso using webapp meilix-generator. It basically fetch the latest release from Github and use mksquashfs tool to extract, made changes and then repack it and mail it. This will take very less time to customize the ISO.

Contributions Best Practices

Commits

  • Write clear meaningful git commit messages (Do read http://chris.beams.io/posts/git-commit/)
  • Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (More info at https://github.com/blog/1506-closing-issues-via-pull-requests )
  • When you make minor changes to a PR of yours (like for example fixing a failing travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterwards so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at https://davidwalsh.name/squash-commits-git )
  • When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.

Feature Requests and Bug Reports

  • When you file a feature request or when you are submitting a bug report to the issue tracker, make sure you add steps to reproduce it. Especially if that bug is a rare one.

Join the development

  • Before you join development, please set up the project on your local machine, run it and go through the application completely. Press on any button you can find and see where it leads to. Explore. (Don't worry ... Nothing will happen to the app or to you due to the exploring 😉 Only thing that will happen is, you'll be more familiar with what is where and might even get some cool ideas on how to improve various aspects of the app.)
  • If you would like to work on an issue, drop in a comment at the issue. If it is already assigned to someone, but there is no sign of any work being done, please free to drop in a comment so that the issue can be assigned to you if the previous assignee has dropped it entirely.

Do read the Open Source Developer Guide and Best Practices at FOSSASIA.

Merging Pull Requests

  • These MUST apply for your pull request to be merged:
    • you provide a screenshot of the working ISO image
    • the build passes
  • Your Pull request can be merged within 24 hours if you get a positive review.
  • Your Pull request can be merged after 24 hours of the last commit and last comment if no maintainer responded.

If the pull request creates a problem, the first person to recognize it should revert the pull requets as soon as possible.

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.