A modern, flexible online system installer for Antergos Linux
karasu Merge pull request #1107 from mpetitjean/0.16.x
Add Belgian French translations
Latest commit e2974d1 Oct 28, 2018
Permalink
Failed to load latest commit information.
.github Fix issue template and add stale bot setup Oct 18, 2018
.tx Revert "change files owned by root to user 1000" Nov 27, 2015
bin Reorganised files (again) Oct 30, 2017
data Removed package Sep 22, 2018
docs Misc docs added Jul 9, 2018
po Add Belgian French translations Oct 28, 2018
scripts Fix log locations. Cleanup select_packages xml retrieval. Sep 4, 2018
src Need root privileges to write to /var/log Oct 26, 2018
test Some code cleaning. Jul 25, 2018
ui Avoid expanding gtkreveal widget Sep 17, 2018
utils Update cnchi.pot #835 Jul 29, 2018
.gitignore Update .gitignore Jul 9, 2018
.landscape.yaml Update .landscape.yaml Dec 18, 2015
AUTHORS Revert "change files owned by root to user 1000" Nov 27, 2015
CHANGES Control that /etc/pacman.conf exists Oct 16, 2018
CHANGES-0.12.0-0.14.0 fix changes Jan 30, 2016
COPYING Revert "change files owned by root to user 1000" Nov 27, 2015
README.md Fix pidof path Oct 4, 2018
TODO.md Nothing important. Just make version number go up Oct 2, 2016
TRANSLATORS Revert "change files owned by root to user 1000" Nov 27, 2015
changes-0.15.md updated changes-0.15 file Sep 2, 2018
cnchi.desktop Fixes issue #133 Dec 28, 2016
debian.sh Updated debian script Oct 17, 2018
dependencies.txt Merge with 0.16.* Aug 8, 2018
requirements.txt Restore requirements.txt file Jul 10, 2018
run Create a fake pacman.conf in debian Oct 17, 2018
update.info Ask networkmanager for connection if we are not inside a VM Oct 23, 2018

README.md

Cnchi GitHub release

Graphical Installer for Antergos Linux

Read the docs Codacy Badge License GitHub issues Github commits Release date Gitter

You are viewing the 0.16.x branch (stable).

Current Status

Development Stage Branch Version Code Status
Cnchi Stable 0.16.x 0.16.12 Frozen
Cnchi Development 0.17.x 0.17.1 Development
Cnchi Next (UI agnostic) master master Development

Usage:

sudo -E cnchi.py

Optional parameters:

Command Description
-a , --a11y Set accessibility feature on by default
-c , --cache Use pre-downloaded xz packages when possible
-d , --debug Sets Cnchi log level to 'debug'
-e , --environment Sets the Desktop Environment that will be installed, see desktop_info.py for options
-f , --force Runs cnchi even if it detects that another instance is running
-n , --no-check Makes checks optional in check screen
-p , --packagelist Install the packages referenced by a local xml instead of the defaults, see #617 for proper usage
-t , --no-tryit Disables first screen's 'try it' option
-v , --verbose Show logging messages to stdout
-V , --version Show Cnchi version and quit
-z , --hidden Show options in development (for developers only, do not use this!)

To create logs to help debug problems:

sudo -E cnchi.py -dv

Reporting bugs:

Please report any issues with Cnchi in the issue tracker. Provide all log files along with a detailed description:

  • /var/log/cnchi/cnchi.log
  • /var/log/cnchi/cnchi-alpm.log (if it exists)
  • /var/log/cnchi/postinstall.log (if it exists)
  • /var/log/cnchi/pacman.log (if it exists)

Translations

We manage our translations via Transifex

Dependencies

  • gtk3
  • python (python3)
  • python-cairo
  • python-chardet
  • python-dbus
  • python-feedparser
  • python-gobject
  • python-idna
  • python-mako
  • python-requests
  • geoip (python-geoip2, python-maxminddb, geoip2-database)
  • pyparted (parted, dosfstools, mtools, ntfs-3g, ntfsprogs)
  • pyalpm (alpm)
  • upower
  • gocryptfs
  • iso-codes
  • clutter, clutter-gtk, clutter-gst
  • gsteamer1.0
  • python-libnacl

Unit tests

  • python-mock

Fonts needed by the keyboard widget

  • ttf-aboriginal-sans
  • ttf-indic-otf
  • ttf-khmer
  • ttf-lohit-fonts
  • ttf-myanmar3
  • ttf-thaana-fonts
  • ttf-tlwg

Building Cnchi

PKGBUILD

Development

Getting started

You will need to install all dependencies.

  • Fork Cnchi
  • Do your changes (use 0.16.x branch as base!)

Then, you can use the run script to test Cnchi. As this is a Installer, you will need to use a Virtual Machine or an additional harddisk to test it.

How to easy prepare a sane testing environment:

  1. Download Antergos ISO
  2. Create a new VM in Virtualbox, add the live iso and a virtual harddisk (two harddisks if you want to cache the downloaded packages)
  3. Run the VM
  4. Cnchi will open, close it.
  5. Remove Cnchi ISO version: sudo rm -rf /usr/share/cnchi
  6. Install git: sudo pacman -S git
  7. Install - Install your Cnchi version from your own repository:
cd /home/antergos
git clone https://github.com/<username>/cnchi
cd cnchi
sudo ln -s /home/antergos/cnchi /usr/share/cnchi
  1. Create a screenshot of the VM (so you don't have to redo all this each time you want to test your changes).
  2. Run Cnchi and start testing!

If your tests are OK, you can then create your PR and push it here (against development branch, which now it's 0.16.x)

Development Tips

When creating a Pull Request (PR), please check that you follow the PEP8 style guide (you have a stylized presentation at pep8.org). You can use pycodestyle (former pep8) or pylint.org or whatever you prefer to check your python3 files.

Spaces are the preferred indentation method.

Documented classes

To start tinkering, we would recommend to check all open #issues and find one you find you will be able to start with (choose something that seems easy to do), so you feel familiar with cnchi's structure. You can find info about it at readthedocs