mina86 / tinyapps

A collection of tiny applications, mirror of repository at SourceForge.net

This URL has Read+Write access

tinyapps / README
100644 210 lines (155 sloc) 9.442 kb
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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
 
                     Tiny Applications Collection
 
Tiny Applications Collection is a set of small programs, shell scripts
and other things which may be useful in everyday life of system
administrators, users and programmers. They can be also used as a
base for a more specialised application as they are all Open Source.
 
If you have written utility which may be useful for others and want to
share it please email me at mina86/AT/mina86.com, I'll be glad to add
your utility to the collection.
 
At the moment the collection includes:
 
 * add - adds specified text to each line from stdin;
 
 * ai-pitr.pl - it's a joke really. A 6 line long AI which might be
   written by Pitr from UserFriendly. For more see:
   http://ars.userfriendly.org/cartoons/?id=19990602 ;
 
 * ai-sid.pl - it's a joke as well. An 8 line long AI which might by
   written by Sid from UserFriendly. Fore more see:
   http://ars.userfriendly.org/cartoons/?id=20001014 ;
 
 * arpping - tool which pings device with given IP using ARP protocol.
   It may be used without IP address assigned to our machine,
   ie. priori to calling DHCP client or such.
 
 * changelog.pl - application providing global change log for
   administrators to fill and users to read. For instance, can be
   used in /etc/profile to show all news;
 
 * cdiff (C and sed versions) - adds ANSI codes to the output of diff
   making it a bit more readable.
 
 * check.sh - performs a defined checking (whether www.googl.com
   responds to pings by default) and runs specified command if failed.
   May be used to automatically shut down PC when connection is lost,
   try to reconnect, monitor a server machine and send message to it's
   admin if it's down, keep given application running and many more;
 
 * checkmail - checks whether mboxes given as arguments contain any
   urnead mail;
 
 * cpuload.sh - tiny script showing the CPU load. May be useful for
   people interested in how it is calculated (see also load and
   traf.sh);
 
 * cutcom - removes C++ comments from stdin and outputs the result to
   stdout;
 
 * drun - it's really 'null' with aditional ability to daemonize
   (hence the name). Helpful when running X applications from
   a terminal.
 
 * extractlinks.pl - extracts links from a HTML page. Useful, for
   example, when downloading an Internet gallery;
 
 * FvwmTransFocus - an FVWM module which changes windows' opacity
   depending on focus. When window looses focus it becomes more
   transparent which looks "neet";
 
 * genpass.sh - generates a random 64-character long password;
 
 * get_mks_vir_bases - downlaods MKS-Vir virus database. Simplified
   version of mksupdate shell script (from mks_vir antivirus). It
   does only download up-to-date virus bases and nothing more;
 
 * getlyrics.pl - downloads lyrics of a given song from the Internet
   (http://www.lyrc.com.ar/ actually);
 
 * gz2bz - a shell script using gzip and bzip2 to convert gzip
   compressed files to bzip2 compressed files.
 
 * infinite-logger - loggs every logged message including the messages
   logget by itself :]
 
 * inplace - a shell script which runs given commmand for all given
   files and replace their content with whatever the command returns;
 
 * installkernel - pretty complex script for installing the Linux
   kernel. It makes a lot of aspects of upgrading the kernel
   automatic. The first versions required bash to run but the now, it
   is believed to run on any POSIX compatible platform so it can be
   run even on small embeded systems;
 
 * ivona.sh - uses IVONA speach synthetiser to say given text. Script
   uses demo available at http://www.ivo.pl/ so it requires an
   Interent conection to work unless it has all required MP3s cached.
   IVONA is a Polish synthesiser so the script is rather useful for
   Poles though it may be used as a base for some English synthesiser.
 
 * lesspipe - an input processor for less pager which automatically
   decompresses compressed files, list contents of archives, list
   contents of a directory, download file from the Internet and many
   more.
 
 * load - shows CPU load, memory and net traffic statistics. It's
   mostly ment for people who are curious how to callculate such
   statistics and use some code from the file in their programs (see
   also cpuload.sh and traf.sh);
 
 * malloc - a small program which allocates memory. Sounds stupid?
   Mayby, but in theory it can help freeing RAM and therefore speeding
   up the machine;
 
 * mountiso - a simple mount/umount wrapper for mounting/unmounting
   ISO images or any other files using loop option. You have to be
   root to use '-o loop' so if you want to mount an ISO image you have
   to login as root. This utility should be SUIDed and then anyoune
   can use it to mount ISO images. By default it is not included when
   installing tinyapps using 'make install' or creating package - you
   need to install it by yourself.
 
 * moz2elinks.pl - converts bookmarks from Mozilla's to ELinks'
   (http://elinks.or.cz) format;
 
 * mp3rip - a command line utility for ripping tracks from CD Audio.
   It uses cdparanoia to rip the tracks and lame to encode them to
   MP3s.
 
 * mpd-show - tool meant to display song currently played in MPD. It
   displays it in a terminal in one line with background indicating
   the progress. It requires libmpdclient.h and libmpdclient.c files
   to compile;
 
 * mpd-state - a program based on Avuton Olrich's state-utils for
   saving and restoring MPD (Music Player Daemon) state. It requires
   libmpdclient.h and libmpdclient.c files to compile;
 
 * mpd-state-wrapper.sh - a small shell script making mpd-state
   behaving like Avuton Olrich's state-utils.
 
 * null - a C program (null.c) and a shell script (null.sh) which
   discard standard input. It is meant for people who thnik that
   '>/dev/null' is too long to type every time. :) It may also be run
   with arguments and the given program will be run and both stdout
   and stderr will be redirected to /dev/null;
 
 * one-time-pass.sh - another joke. It works like passwd with this
   difference that it automatically generates a random password which
   is not revealed to the user, therefore he doesn't know his own
   password;
 
 * pingrange.pl - pings a range of addresses;
 
 * quotes.txt - a collection of quotations (some are in Polish);
 
 * rand-files.pl - chooses a random set of files, where each file may
   have its own rank or probability, read from standard input such
   that their size is no greater then given limit. Useful for
   choosing random set of songs to copy to our portable player.
 
 * rot13 - performs an ROT13 'encryption' on stdin;
 
 * settitle - sets the title of xterm, rxvt, Eterm, aterm and other
   xterm-compatible terminals;
 
 * show - shows colourised (if ccza is available) log file with
   possible option of searching for a pattern. Small but handy - you
   don't have to write `less /var/log/syslog` anymore and get ugly
   black and white log;
 
 * SlackBuild.gen - generates a SlackBuild template. It was not
   really debugged yet but I believe that it'll work quit good;
 
 * splitlines.sh - Splits input, line-by-line, into several files so
   that the 1st line goes to the 1st file, the 2nd to the 2nd file and
   so on till it wraps and n+1st line goes to 1st file. I use it when
   I want to download a lot of small files using a few instances of
   wget - it's enough to split file with urls to 2 or 3 files and run
   2/3 instances of wget in the background.
 
 * the-book-of-mozilla.txt - a collection of quotations from The Book
   of Mozilla (most are unofficial);
 
 * timer - a text-mode timer counting with accuracy to 0.01 s;
 
 * tpwd - truncates PWD to specified number of characters. May be
   used in PS1 to display only the end of the PWD instead of a full
   60-character long PWD which doesn't really look nice;
 
 * traf.sh - tiny script showing traffic statistics. Many things are
   hardcoded in the source but it may be useful for future
   modifications or to learn how traffic is calculated (see also
   cpuload.sh and load);
 
 * tuptime - my personal favourite :) Displays total (sum of all
   uptimes) and biggest uptime. Might be used as replacement to
   standard uptime utility;
 
 * tv - Perl script showing TV programme. It gets data from tv.o2.pl
   so it's usable for Poles mostly but in the future it is planned to
   provide plugins allowing to download data from other sites.
 
 * virtman.sh - adds virtual hosts to Apache configuration for given
   user. May be added to some kind of adduser script for automagical
   addition of virtual hosts.
 
 * xcolor2rgb - reads from argument list (or from stdin, if no
   arguments are given) and prints appropriate RGB value to stdout.
 
 * xgetclass - prints window's application name and class as returned
   by XGetClassHint. May be used in some kind of shell scripts but
   honestly I just wrote it to test XGetClassHint function and since
   I did it I decided to include it in tinyapps. :)
 
More documentation about each utility is usually provided in the
source code.