Graphical Installer for Linux4All, and a fork of CNCHI
sudo -E cnchi.py| 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 -dvPlease 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)
- 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
- python-mock
- ttf-aboriginal-sans
- ttf-indic-otf
- ttf-khmer
- ttf-lohit-fonts
- ttf-myanmar3
- ttf-thaana-fonts
- ttf-tlwg
You will need to install all dependencies.
- Fork Lanchie/Cnchi
- Do your changes
Then, you can use the run script to test Lanchie. 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:
- Download Linux4All ISO
- Create a new VM in Virtualbox, add the live iso and a virtual harddisk (two harddisks if you want to cache the downloaded packages)
- Run the VM
- Install git:
sudo pacman -S git - Install - Install your Cnchi version from your own repository:
cd /home/live
git clone https://github.com/<username>/cnchi
cd cnchi
sudo ln -s /home/live/cnchi /usr/share/cnchi
- Create a screenshot of the VM (so you don't have to redo all this each time you want to test your changes).
- Run Lanchie/Cnchi and start testing!
If your tests are OK, you can then create your PR and push it here
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.
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 Lanchie's structure. You can find info about it at readthedocs