-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
67 lines (57 loc) · 2.86 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
INTERNET ICON v. 1.1
--------------------
Internet icon is a small desktop application that notifies the user about his internet connection.
The application displays a tray icon or shows a notification message, depending on the desktop
environment or the user's choice. The software is open source (GPL 3).
INSTALLATION
------------
Compile and install the application as usual. Download the package from github:
https://github.com/pagolo/internet-icon/archive/v.1.1.tar.gz
(or use the git clone command, if you have git installed)
unpack the archive and enter the folder internet-icon-v.1.1
then execute these commands:
./configure
make
sudo make install
For details see the INSTALL file.
CONFIGURATION
-------------
The first time is launched, the application creates an xml configuration file in the home folder,
named ".internet_icon".
Normally you can leave it unmodified, in any case you can modify it by hand. Please restart the
application if you modify the configuration.
Tags explanation
----------------
<timeout> default value: 20. Number of seconds between each internet connection check out.
minimum value: 10.
<test_ip> and <test_port> default values: "auto" and 53. Ip address and port to be checked.
Please use ip address, not domain name! "auto" indicates your dns servers ip.
<opmode> default value: "auto". The operational mode, i.e. "status-icon", "notification",
or "auto"; "status-icon" displays an icon on the system tray (make sure it is visible),
"notification" shows a message when the internet status changes, "auto" displays icon
or notification based on program's choice.
<wan_ip_page> default value: "ifconfig.me/ip". The url to automatically get your wan ip.
<user_agent> default value: "InternetIcon/Getting wan ip". The user agent, as required by the
"what is my ip" server.
TECHNICAL NOTE
--------------
Perhaps it would be better using a ping instead of a real connection; however ping in linux requires
root previleges, so I chose a normal connection that is immediatly closed.
AUTO STARTING
-------------
You can automatically start the application when desktop session starts, both in Gnome and Kde.
Using Gnome run "gnome-session-properties", then add a startup application, specifying full path
of the executable code (typically /usr/local/bin/internet_icon).
Using Kde create a symbolic link from the same path to .kde/Autostart folder:
ln -s /usr/local/bin/internet_icon .kde/Autostart
TRANSLATION
By default, only italian translation is present. If you create a translation for your language,
please let me know, so I can add your translation to the archive.
To generate catalog file, follow these steps:
cd <project folder>
cd po
make internet_icon.pot
CONTACT
-------
Author: P. Bozzo
Email: pagolo DOT bozzo AT gmail DOT com