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 1: Line 1:
 
[https://github.com/bougyman/wifish Wifish] is a console-based wireless networking connection manager created by Void developer [https://github.com/bougyman/ bougyman].  
 
[https://github.com/bougyman/wifish Wifish] is a console-based wireless networking connection manager created by Void developer [https://github.com/bougyman/ bougyman].  
According to the project's Github page,
+
According to the project's Github page, wifish is designed to
<blockquote>Wifish (from wifi.sh) is meant to do very little. Design Goals are
 
 
*List Available Wifi APs
 
*List Available Wifi APs
*Connect to an AP
+
*Connect to an AP  
That is all.
 
</blockquote>
 
  
 
Contrary to this, wifish has a couple of extra features that make it a compelling minimalist wireless network manger -- it will update your <code>wpa_supplicant.conf </code> with the network information.
 
Contrary to this, wifish has a couple of extra features that make it a compelling minimalist wireless network manger -- it will update your <code>wpa_supplicant.conf </code> with the network information.
  
--Installation--
+
=Installation=
  
 
Install wifish via
 
Install wifish via
 
   <code># xbps-install wifish</code>
 
   <code># xbps-install wifish</code>
  
--Usage--
+
Next, enable the <code>wpa_supplicant</code> service:
 
 
First, enable the <code>wpa_supplicant</code> service:
 
 
  <code># ln -s /etc/sv/wpa_supplicant/ /var/service/</code>
 
  <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.
 
Then run <code>wpa_cli status</code> and ensure that wpa_supplicant is functioning properly.
Line 27: Line 22:
 
  <code># groupadd wifish</code>
 
  <code># groupadd wifish</code>
 
  <code># usermod -a -G wifish ''your_user_name''</code>
 
  <code># usermod -a -G wifish ''your_user_name''</code>
 +
 +
=Usage=
 +
==Listing networks==
 +
<code>wifish list</code will print available networks in the terminal and then exit.
 +
<code>wifish menu</code> will present an ncurses menu listing the available networks (along with the the option to connect to one). <code>wifish menu</code> requires the <code>dialog</code> package to be installed.
  
 
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:
 
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:
 
  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 <code>SCAN_SECONDS</code> at runtime:
+
But if you don't need/want to wait 5 seconds every time you want to connect, you can just pass <code>SCAN_SECONDS</code> at runtime:
 
  SCAN_SECONDS=5 wifish
 
  SCAN_SECONDS=5 wifish
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.
+
 
 +
==Connecting to a network==
 +
You can connect to a network from the terminal by running
 +
<code>wifish connect ''network_ssid''</code>
 +
If the network is password protected, you'll be prompted for the password and whether you'd like to store the connection information.
 +
 
 +
<code>wifish menu</code> can also be used to connect in a similar fashion to <code>wifish connect</code>, but uses an ncurses interface.

Revision as of 09:49, 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 is designed to

  • List Available Wifi APs
  • Connect to an AP

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

Next, 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

Usage

Listing networks

wifish list</code will print available networks in the terminal and then exit. wifish menu will present an ncurses menu listing the available networks (along with the the option to connect to one). wifish menu requires the dialog package to be installed.

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 just pass SCAN_SECONDS at runtime:

SCAN_SECONDS=5 wifish

Connecting to a network

You can connect to a network from the terminal by running

wifish connect network_ssid

If the network is password protected, you'll be prompted for the password and whether you'd like to store the connection information.

wifish menu can also be used to connect in a similar fashion to wifish connect, but uses an ncurses interface.