===============================
Ubuntu post-installation script
With this Python script you will avoid wasting time to install and
configure your Ubuntu operating system. Just download this script,
run it with your favorite configuration file and ... envoy !
The script can:
- Install Ubuntu repositories (deb repos, PPA, ...)
- Install packages
- Configure dots files (.bashrc, .vimrc, ...)
- Configure the user interface (support Unity and Gnome Shell)
- Run every command line
How to use this script ?
Just download and run it with the following command lines:
$ wget https://raw.github.com/nicolargo/ubuntupostinstall/master/ubuntu-13.04-postinstall.py
$ chmod a+x ubuntu-13.04-postinstall.py
$ sudo ./ubuntu-13.04-postinstall.py
By default, the script will download and use this configuration file.
https://github.com/nicolargo/ubuntupostinstall/blob/master/ubuntu-13.04-unity-postinstall.cfg
Use anothers configurations files
Using the -c option, you can select an alternative configuration file.
For example, you can configure Ubuntu for Gnome Shell using:
$ sudo ./ubuntu-13.04-postinstall.py -c https://raw.github.com/nicolargo/ubuntupostinstall/master/ubuntu-13.04-gnomeshell-postinstall.cfg
If you want to use a local configuration file (adapted to yours needs):
$ sudo ./ubuntu-13.04-postinstall.py -c mycfg.cfg
Create your own configuration file
The configuration files is organized into sections, and each section
can contain name-value pairs for configuration data.
preactions section
This is the first section of the configuration file.
A line starting with the action_ string (following by the action name) defines a
action (command line) to be executed.
The action name will be displayed during the script execution.
The lines will be executed before all the others steps.
Example:
[preactions]
action_dummy = dpkg -l > /tmp/pkg-before.txt
The dummy action will create a /tmp/pkg-before.txt with a listing of
all the packages installed on your system.
repos section
In this section, user can install the repositories (deb repository or PPA).
- ppa_xxx = ppa:ppauser/ppaname > Add the ppa:ppauser/ppaname to the system
- pkg_xxx = pkglist > Add the package list (space separed) to the system
- url_xxx = http://reposurl > Add the repository URL to the system
- key_xxx = key > Add the repository key to the system
xxx define the name of the action and will be displayed during the script execution.
Example:
[repos]
ppa_glances = ppa:arnaud-hartmann/glances-stable
pkg_glances = glances
Install the Glances PPA on the system and install the glances software.
packages section
From this section, you can install all your softwares, gathered by
function, needs...
If the item starts with remove_ then packets are uninstalled.
Example:
[packages]
network = iftop ifstat
dev = vim git
Install iftop, ifstat, vim and git. Display "Install network packages" and "Install
dev packages" during the script execution.
Example:
[packages]
remove_unuse = eclipse
Remove eclipse. Display "Remove unuse" during the script execution.
dotfiles section
This section is dedicated to the dot files (.bash, .vimrc...) installed in your
home folder.
The script can install the following dot files from URL:
- bashrc: BASH main configuration file
- bashrc_prompt: BASH prompt configuration
- bashrc_aliases: BASH aliases
- vimrc: VIM main configuration file
- htoprc: HTOP main configuration file
Example:
[dotfiles]
bashrc = https://raw.github.com/nicolargo/dotfiles/master/bashrc
Create the ~/.bashrc from the https://raw.github.com/nicolargo/dotfiles/master/bashrc
unity and gnome3 sections
Configure Unity or Gnome Shell:
- theme: Configure the GTK theme (name)
- icons: Configure the icons theme (name)
- cursors: Configure the cursors theme (name)
- conky: Conky main configuration file (URL)
For the themes, packages have to be installed in the repos or packages sections.
[gnome3]
theme = Boomerang
icons = Faenza
cursors = DMZ-White
conky = https://raw.github.com/nicolargo/ubuntupostinstall/master/conkyrc
Configure Gnome Shell with the Boomerang GTK theme, Faenza icons and DMZ-White
cursors. Configure Conky with the https://raw.github.com/nicolargo/ubuntupostinstall/master/conkyrc
configuration file.
You can NOT use both unity and gnome3 section in the same .cfg file.
postactions section
This is the last section of the configuration file.
A line starting with the action_ string (following by the action name) defines a
action (command line) to be executed.
The action name will be displayed during the script execution.
The lines will be executed after all the others steps.
Example:
[postactions]
action_dummy = dpkg -l > /tmp/pkg-after.txt
The dummy action will create a /tmp/pkg-before.txt with a listing of
all the packages installed on your system after the script execution.
Contribute ?
Need a new function ?
Found a bug ?
Please fill an issue here: https://github.com/nicolargo/ubuntupostinstall/issues/new
