forked from nicolargo/ubuntupostinstall
/
README
177 lines (109 loc) · 5.09 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
===============================
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