https://github.com/conjikidow/utokyo-wifi-connector

An unofficial command-line tool to connect to the UTokyo Wi-Fi.
https://github.com/conjikidow/utokyo-wifi-connector

Last synced: 27 days ago
JSON representation

An unofficial command-line tool to connect to the UTokyo Wi-Fi.

• Host: GitHub
• URL: https://github.com/conjikidow/utokyo-wifi-connector
• Owner: conjikidow
• License: mit
• Created: 2024-04-22T21:51:29.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-05-01T17:14:13.000Z (8 months ago)
• Last Synced: 2024-10-25T02:45:40.779Z (3 months ago)
• Language: Shell
• Homepage:
• Size: 10.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# utokyo-wifi-connector

An unofficial command-line tool to manage connections to UTokyo WiFi and eduroam networks using NetworkManager (nmcli).

## Installation

1. Clone this repository:

    ```bash

    git clone [email protected]:conjikidow/utokyo-wifi-connector.git

    ```

2. Navigate to the project directory:

    ```bash

    cd utwifi

    ```

3. Make the script executable:

    ```bash

    chmod +x utwifi

    ```

4. Create a symbolic link to the script in a directory included in your `$PATH`. For example:

    ```bash

    sudo ln -s $(pwd)/utwifi /usr/local/bin

    ```

    or

    ```bash

    # Make sure that ~/.local/bin is included in your $PATH

    ln -s $(pwd)/utwifi ~/.local/bin

    ```

5. [Optional] (If you are using `zsh`) Generate the `zsh` completion script and add it to your `fpath`. For example:

    ```zsh

    # Make sure that ~/.zfunc is included in your $fpath

    utwifi completion > ~/.zfunc/_utwifi

    ```

    In order to add `~/.zfunc` to your `fpath` and enable completion, add the following lines to your `.zshrc`:

    ```zsh

    export fpath=(~/.zfunc $fpath)

    autoload -U compinit && compinit

    ```

## Usage

### Add Connections

To add connections to UTokyo WiFi and eduroam networks, run:

```bash

utwifi add

```

Follow the prompts to enter your user ID and password.

### Update Connections

To update existing connections, run:

```bash

utwifi update

```

Follow the prompts to update the user ID and password for each connection.

### Delete Connections

To delete existing connections, run:

```bash

utwifi delete

```

### View Connection Information

To view information about existing connections, run:

```bash

utwifi info

```

### Generate Completion Script

To generate a completion script for `zsh`, run:

```bash

utwifi completion

```

Currently, only `zsh` is supported.

### Help

For help and available subcommands, run:

```bash

utwifi help

```