Skip to content

Home

Jump to bottom Edit New page
drinkcat edited this page Jun 26, 2013 · 44 revisions

Introduction

There's tips for using crouton floating all around the interwebs. This wiki is for collecting them in one space. Anything core to the usage of crouton will probably be moved into the README, but device-, environment-, and application- specific usage tips can find a home here.

Contributing

Feel free to add your tips and tricks to the wiki. Do test any commands and scripts you post before submitting them, and try to clean up your instructions. Don't be surprised or offended when the crouton author(s) and other upstanding community members tweak your tips to make the style consistent, or to work in more general situations. All tips should be placed in sub-pages, linked in the appropriate category. It's better to make a separate page for your trick than to have a long page of disparate and unorganized tips, but if you have a bunch of one-liner hints that fit into a coherent group, go ahead and combine them into one page.

Usage Tips & Tricks

  • Keyboard: How to install Chromebook keyboard layout, add custom key bindings, etc.

Installer

Backups

Use sudo edit-chroot -b nameofchroot (in a crosh terminal shell) to back up your chroot, and sudo edit-chroot -r nameofchroot to restore it. edit-chroot will warn you if you're clobbering a chroot by restoring, in which case you need to run sudo edit-chroot -rr nameofchroot (two r's to confirm that you want to clobber it). You can change the source and destination tarball using -f.

If you get an error that the -b option is not available in edit-chroot, it means you need to download the latest version of crouton and use it to update your chroot. The crouton update flag is -u. For example sudo sh -e crouton -r raring -t xfce -u could be used to update an existing chroot based on the Raring Release and xfce Target. The update includes a newer version of edit-chroot which support the -b and -r options.

In the event that you want to restore a backup to a stock chromebook (with developer mode enabled) you can use the crouton installer with the -f option specifying the backup's tarball, e.g., sudo sh -e crouton -r raring -t xfce -f /media/removable/SD\ Card/backup/raring-20130617-1234.tar.gz

Devices

Chromebook Pixel

Distributions

Desktop Environments

awesome

  • awesome works fine in crouton:

    1. Install X11: sudo sh -e ./crouton -t x11
    2. Enter the chroot: sudo enter-chroot
    3. Install awesome: sudo apt-get install awesome
    4. Add exec awesome to ~/.xinitrc: echo "exec awesome" > ~/.xinitrc
    5. Copy default configuration from /etc/xdg/awesome: cp -r /etc/xdg/awesome ~/.config/.
    6. Start X11 to try it out: xinit

  • Launch awesome directly from the crosh shell: sudo enter-chroot xinit

  • On Chromebooks, the search key (right below tab) is actually the 'Mod4' key. awesome works with it right out of the box!

Applications

Add a custom footer
Add a custom sidebar
Clone this wiki locally