summaryrefslogtreecommitdiff
path: root/plugins/ProxySwitch/docs/proxySwitch.html
blob: 8106e13d1e32e06d89ff5e3387d3dda0c5770844 (plain)
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
211
212
213
214
215
216
217
218
219
220
221
222
223
224
<html>
<head>
<title>proxySwith - Automatic proxy settings manager</title>
<link rel="stylesheet" href="proxySwitch.css" type="text/css" />
<link rev="made" href="mailto:" />
</head>

<body>

<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->

<ul>

	<li><a href="#name">NAME</a></li>
	<li><a href="#features">FEATURES</a></li>
	<ul>

		<li><a href="#screenshot">Screenshot</a></li>
	</ul>

	<li><a href="#requirements">REQUIREMENTS</a></li>
	<li><a href="#download">DOWNLOAD</a></li>
	<ul>

		<li><a href="#plugin">Plugin</a></li>
		<li><a href="#miranda">Miranda</a></li>
	</ul>

	<li><a href="#change_history">CHANGE HISTORY</a></li>
	<li><a href="#author">AUTHOR</a></li>
</ul>
<!-- INDEX END -->

<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>proxySwith - Automatic proxy settings manager</p>
<p>
</p>
<hr />
<h1><a name="features">FEATURES</a></h1>
<p>proxySwitch can enable/disable proxy in Miranda IM, Internet Explorer, and
Firefox based on the current IP address and defined rules. This plugin
is useful mainly for laptop/notebook owners.</p>
<p></p>
<ul>
<li><a name="item_enables_2fdisables_proxy_for_all_miranda_im_plugin">enables/disables proxy for all Miranda IM plugins on startup and later on any IP address change</a><br />
</li>
<li><a name="item_reconnects_all_miranda_im_protocols_if_necessary">reconnects all Miranda IM protocols if necessary</a><br />
</li>
<li><a name="item_notifies_user_on_every_network_interface_ip_addres">notifies user on every network interface IP address change</a><br />
</li>
<li><a name="item_recognizes_which_network_interface_is_used_by_mira">recognizes which network interface is used by Miranda IM and reconnects if that interface loses IP address</a><br />
</li>
<li><a name="item_addresses">can display current IP addresses (per interface)</a><br />
</li>
<li><a name="item_clipboard">can copy current IP address to clipboard (per interface)</a><br />
</li>
<li><a name="item_explorer">enables/disables proxy for Internet Explorer (no need to restart IE)</a><br />
</li>
<li><a name="item_firefox">enables/disables proxy for Firefox (you must close and rerun Firefox)</a><br />
</li>
<p></p></ul>
<p>Why I wrote this plugin? Because I don't want to do many things manually:</p>
<p></p>
<ul>
<li><a name="item_i_have_to_use_a_proxy_server_at_work_but_i_don_27t">I have to use a proxy server at work but I don't have one at home this plugin will change the settings for me when I change the place</a><br />
</li>
<li><a name="item_cable">I'm connected to LAN and Wifi at the same time and when I unplug the ethernet cable (rushing to the meeting) I want Miranda to reconnect using Wifi but only if it was connected via ethernet cable</a><br />
</li>
<p></p></ul>
<p>And what the plugin can't do?</p>
<p></p>
<ul>
<li><a name="item_if_you_need_other_software_27s_proxy_usage_to_be_m">If you need other software's proxy usage to be managed by this plugin feel free to modify the source and build your version of proxySwitch.</a><br />
</li>
<li><a name="item_home">It's not intended for changing the proxy setup. If you need proxy_1 at work and proxy_2 at home (or other location) this plugin will be useless for you. Well, this functionality could be added... Any volunteers?</a><br />
</li>
<p></p></ul>
<p>
</p>
<h2><a name="screenshot">Screenshot</a></h2>
<div align=center>
<img src=screenshot.gif width=500 height=364 border=1 hspace=10>
</div><p>
</p>
<hr />
<h1><a name="requirements">REQUIREMENTS</a></h1>
<p>This plugin requires modified Netlib. It is not possible to change the
proxy settings run-time and it is not possible to determine which network
interface is used by Miranda IM without this modification. It means that
you need new modified miranda32.exe!</p>
<p>If you compile miranda for yourself you can download a patch file otherwise
pre-compiled binary is ready for you.</p>
<p>The updated Miranda should have ``(Netlib modf)'' tag on the About dialog.</p>
<p>I hope my modification will be soon incorporated into Miranda IM v0.4 official source tree.</p>
<p>
</p>
<hr />
<h1><a name="download">DOWNLOAD</a></h1>
<p>
</p>
<h2><a name="plugin">Plugin</a></h2>
<p>Download or install the plugin using Miranda Installer. The source
is available also. Please note the requirements above.</p>
<table style="border: 2px solid #a82013; font-size: 95%; background-color: #ffffe0;">
<col style="width: 10em;">
<col style="width: 5em;">
<col style="width: 13em;">
<tr>
  <td>Plugin binaries</td>
  <td>v1.0.0.1</td>
  <td><a href="http://miranda-im.org/download/feed.php?dlfile=1682">proxySwitch.zip</a></td>
</tr>
<tr>
  <td style="border-top: 1px solid #B82619;">Plugin installation</td>
  <td style="border-top: 1px solid #B82619;">v1.0.0.1</td>
  <td style="border-top: 1px solid #B82619;"><a href="http://miranda-im.org/download/feed.php?mirinst=1&dlfile=1682">proxySwitch.mir</a></td>
</tr>
<tr>
  <td style="border-top: 1px solid #B82619;">Plugin source</td>
  <td style="border-top: 1px solid #B82619;">v1.0.0.1</td>
  <td style="border-top: 1px solid #B82619;"><a href="http://miranda-im.org/download/feed.php?dlsource=1682">proxySwitch_src.zip</a></td>
</tr>
</table><p>
</p>
<h2><a name="miranda">Miranda</a></h2>
<p>Replace your miranda32.exe with the respective version downloaded from this
page. Or you can download a patch file to modify the source and you can
compile it for yourself.</p>
<table style="border: 2px solid #a82013; font-size: 95%; background-color: #ffffe0;">
<col style="width: 14em;">
<col style="width: 6em;">
<col style="width: 20em;">
<tr>
  <td>Modified miranda32.exe</td>
  <td>v0.3.3.1</td>
  <td><a href="http://trooper.tricube.cz/miranda-0.3.3.1.zip">miranda-0.3.3.1.zip</a></td>
</tr>
<tr>
  <td>&nbsp;</td>
  <td>v0.3.4</td>
  <td><a href="http://trooper.tricube.cz/miranda-0.3.4.zip">miranda-0.3.4.zip</a></td>
</tr>
<tr>
  <td>&nbsp;</td>
  <td>v0.4</td>
  <td><a href="http://trooper.tricube.cz/miranda-0.4.zip">miranda-0.4.zip</a></td>
</tr>
<tr>
  <td style="border-top: 1px solid #B82619;">Miranda source diff</td>
  <td style="border-top: 1px solid #B82619;">v0.3.3.1</td>
  <td style="border-top: 1px solid #B82619;"><a href="http://trooper.tricube.cz/miranda_modif_netlib_v0331.diff">miranda_modif_netlib_v0331.diff</a></td>
</tr>
<tr>
  <td>&nbsp;</td>
  <td>v0.3.4</td>
  <td><a href="http://trooper.tricube.cz/miranda_modif_netlib_v034x.diff">miranda_modif_netlib_v034x.diff</a></td>
</tr>
<tr>
  <td>&nbsp;</td>
  <td>v0.4</td>
  <td><a href="http://trooper.tricube.cz/miranda_modif_netlib_v04xx.diff">miranda_modif_netlib_v04xx.diff</a></td>
</tr>
</table><p>Apply the diff to the Miranda source manually or using Cygwin GNU patch program:</p>
</p><pre>
patch -l -u -d miranda_src331 -p 1 &lt; miranda_modif_netlib_v03xx.diff
</pre>

<p>
</p>
<hr />
<h1><a name="change_history">CHANGE HISTORY</a></h1>
<p></p>
<dl>
<dt><strong><a name="item_1">v1.0.0.1 (2005-03-11)</a></strong><br />
</dt>
<p></p>
<ul>
<li><a name="item_plugin_can_now_handle_firefox_proxy_settings_but_u">Plugin can now handle Firefox proxy settings but unlike IE you have to close and reopen Firefox windows to take the change effect</a><br />
</li>
<li><a name="item_reconnects_miranda_on_any_ip_address_change_if_off">Reconnects Miranda on any IP address change if offline and Always Reconnect is selected</a><br />
</li>
<li><a name="item_fixed_detection_of_network_interfaces_used_by_mira">Fixed detection of network interfaces used by Miranda IM</a><br />
</li>
<li><a name="item_fixed_options_ui_layout">Fixed options UI layout</a><br />
</li>
<p></p></ul>
<p></p></dl>
<p></p>
<dl>
<dt><strong><a name="item_2">v0.0.2 (2005-01-18)</a></strong><br />
</dt>
<p></p>
<ul>
<li><a name="item_improved_detection_of_network_interface_used_by_mi">Improved detection of network interface used by Miranda IM now does not require Win XP+</a><br />
</li>
<li><a name="item_fixed">Fixed (enlarged) UI to enable translation to other languages</a><br />
</li>
<li><a name="item_fixed_crash_when_new_network_interface_is_discover">Fixed crash when new network interface is discovered or existing one is disabled</a><br />
</li>
<p></p></ul>
<p></p></dl>
<p></p>
<dl>
<dt><strong>v0.0.1 (2005-01-15)</strong><br />
</dt>
<p></p>
<ul>
<li><a name="item_first_public_release">First public release</a><br />
</li>
<p></p></ul>
<p></p></dl>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<p>Petr Smejkal &lt;<em><a href="mailto:petr.smejkal@seznam.cz">petr.smejkal@seznam.cz</a></em>&gt;, 11 March 2005.</p>

</body>

</html>