https://github.com/benwainwright/reithd

Never have to think about Reith ever again...
https://github.com/benwainwright/reithd

bbc daemon macosx proxy reith

Last synced: 20 days ago
JSON representation

Never have to think about Reith ever again...

• Host: GitHub
• URL: https://github.com/benwainwright/reithd
• Owner: benwainwright
• Created: 2019-07-26T23:06:29.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-02-07T15:16:43.000Z (almost 5 years ago)
• Last Synced: 2023-02-28T07:51:46.508Z (almost 2 years ago)
• Topics: bbc, daemon, macosx, proxy, reith
• Language: Swift
• Homepage:
• Size: 521 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
#  reithd

This project is a daemon for mac users that automatically reconfigures the user's system when connecting and disconnecting to the BBC corporate network ("Reith")

## Install

Install via homebrew as follows

```

brew tap benwainwright/tools https://github.com/benwainwright/reithd

brew install reithd

```

This will install reithd as a homebrew service. You can start and stop the service with `brew services start reithd` and `brew services stop reithd`. See the below sections for details of how to configure your shell and SSH setup to work with reithd

## What does it do?

When running, the daemon monitors the System Configuration database looking for changes in your DNS setup. When one occurrs, it will detect whether the new connection is a Reith network connection and reconfigure your system accordingly

### Network Location

Your network location will be switched to "BBC On Network" or "BBC Off Network" appropriately

### Shell

All shells that are configured to use reithd will automatically have their environment reconfigured with the correct proxy environment variables _immediately and transparently_. In order to configure your shell, you will need to insert the following line somewhere in your `~/.zshrc` or `~/.bashrc` file:

```bash

eval "$(reithd shell)"

```

#### How this works

This will inject a script into your shell startup which creates and removes pid files in `~/.reithd` when shell process starts up and shuts down respectively. When a change is detected, `reithd` will check this folder, collect the pid numbers and send `SIGUSR1` or `SIGUSR2` signals to each configured shell proccess. The injected shell startup script configures your shell to respond to these signals by either removing or adding proxy variables.

### Spotify

If you have Spotify installed, your preferences will be automatically edited to include the Reith proxy address. You'll still need to restart Spotify though (I'm considering adding an automatic restart)

### SSH

Reithd will generate a file called `~/.ssh/config.reith.socks` and automatically comment out or uncomment any lines starting with `ProxyCommand` when the network changes. You can make use of this file by inserting the line

```bash

include ~/.ssh/config.reith.socks

```

anywhere in your `~/.ssh/config` file