Warning: THE VOID WIKI IS DEPRECATED. It is no longer being maintained, contains outdated and incorrect information, and will eventually be shut down. Please refer to the Void Handbook, https://docs.voidlinux.org/, for the official documentation. If you can't find the information you're seeking, please raise an issue at https://github.com/void-linux/void-docs/issues

Difference between revisions of "Wifish -"

From Void Linux Wiki
Jump to navigation Jump to search
Line 10: Line 10:
  
 
--Installation--
 
--Installation--
 +
 
Install wifish via
 
Install wifish via
{{Codeline|# xbps-install wifish}}
+
  <code># xbps-install wifish</code>
  
 
--Usage--
 
--Usage--
First, enable the {{Codeline|wpa_supplicant}} service:
 
{{Codeline|# ln -s /etc/sv/wpa_supplicant/ /var/service/}}
 
Then run {{Codeline|wpa_cli status}} and ensure that wpa_supplicant is functioning properly.
 
  
Next, make sure your user account is able to manipulate {{Codeline|wpa_supplicant}} by checking {{Codeline|/etc/wpa_supplicant/wpa_supplicant.conf}}. By default you should see:
+
First, enable the <code>wpa_supplicant</code> service:
 +
<code># ln -s /etc/sv/wpa_supplicant/ /var/service/</code>
 +
Then run <code>wpa_cli status</code> and ensure that wpa_supplicant is functioning properly.
 +
 
 +
Next, make sure your user account is able to manipulate <code>wpa_supplicant}} by checking <code>/etc/wpa_supplicant/wpa_supplicant.conf</code>. By default you should see:
 
  ctrl_interface=/run/wpa_supplicant
 
  ctrl_interface=/run/wpa_supplicant
 
  ctrl_interface_group=wheel
 
  ctrl_interface_group=wheel
 
  update_config=1
 
  update_config=1
This tells us that members of the {{Codeline|wheel}} group have permission to update {{Codeline|/etc/wpa_supplicant/wpa_supplicant.conf}} and control wireless interface settings. You can either add your user account to {{Codeline|%wheel}}, or you can choose another group/create a new group and add your user account to it:
+
This tells us that members of the <code>wheel</code> group have permission to update <code>/etc/wpa_supplicant/wpa_supplicant.conf</code> and control wireless interface settings. You can either add your user account to <code>%wheel</code>, or you can choose another group/create a new group and add your user account to it:
  {{Codeline|# groupadd wifish}}
+
  <code># groupadd wifish</code>
  {{Codeline|# usermod -a -G wifish ''your_user_name''}}
+
  <code># usermod -a -G wifish ''your_user_name''</code>
  
By default, <code>wifish</code> does not ''effectively'' scan for available networks - it will read wpa_supplicant's most recent scan. You can edit {{Codeline|/usr/bin/wifish}} to change the defaults:
+
By default, <code>wifish</code> does not ''effectively'' scan for available networks - it will read wpa_supplicant's most recent scan. You can edit <code>/usr/bin/wifish</code> to change the defaults:
  {{Codeline|SCAN_SECONDS=5}}
+
  SCAN_SECONDS=5
But if you don't need/want to wait 5 seconds every time you want to connect, you can pass SCAN_SECONDS at runtime:
+
But if you don't need/want to wait 5 seconds every time you want to connect, you can pass <code>SCAN_SECONDS</code> at runtime:
  {{Codeline|SCAN_SECONDS=5 wifish}}
+
  SCAN_SECONDS=5 wifish
If you have {{Codeline|dialog}} installed, you will get an ncurses-based menu listing the available wireless networks. Otherwise, {{Codeline|wifish}} will print the available networks and their information into the terminal and then exit.
+
If you have <code>dialog</code> installed, you will get an ncurses-based menu listing the available wireless networks. Otherwise, <code>wifish</code> will print the available networks and their information into the terminal and then exit.

Revision as of 09:01, 12 November 2015

Wifish is a console-based wireless networking connection manager created by Void developer bougyman. According to the project's Github page,

Wifish (from wifi.sh) is meant to do very little. Design Goals are

  • List Available Wifi APs

*Connect to an AP That is all.

Contrary to this, wifish has a couple of extra features that make it a compelling minimalist wireless network manger -- it will update your wpa_supplicant.conf with the network information.

--Installation--

Install wifish via

 # xbps-install wifish

--Usage--

First, enable the wpa_supplicant service:

# ln -s /etc/sv/wpa_supplicant/ /var/service/

Then run wpa_cli status and ensure that wpa_supplicant is functioning properly.

Next, make sure your user account is able to manipulate wpa_supplicant}} by checking /etc/wpa_supplicant/wpa_supplicant.conf. By default you should see:

ctrl_interface=/run/wpa_supplicant
ctrl_interface_group=wheel
update_config=1

This tells us that members of the wheel group have permission to update /etc/wpa_supplicant/wpa_supplicant.conf and control wireless interface settings. You can either add your user account to %wheel, or you can choose another group/create a new group and add your user account to it:

# groupadd wifish
# usermod -a -G wifish your_user_name

By default, wifish does not effectively scan for available networks - it will read wpa_supplicant's most recent scan. You can edit /usr/bin/wifish to change the defaults:

SCAN_SECONDS=5

But if you don't need/want to wait 5 seconds every time you want to connect, you can pass SCAN_SECONDS at runtime:

SCAN_SECONDS=5 wifish

If you have dialog installed, you will get an ncurses-based menu listing the available wireless networks. Otherwise, wifish will print the available networks and their information into the terminal and then exit.