Skip to content

Hub for the Wifi Translation Android app to enable management and unicast web-player fallback

License

Notifications You must be signed in to change notification settings

sblandford/WifiTranslationHub

Repository files navigation

WifiTranslationHub

Hub written in Python 3.5+ for the Wifi Translation Android app to enable management and unicast web-player fallback

Intended for use with the WifiTranslation Android app https://github.com/sblandford/WifiTranslation.

What it is for

The WifiTranslation Android app uses multicast to transmit simultaneous translation over a Wifi network. This is fine if everyone is using an Android phone that has multicast enabled however many people will be using IOS devices or mutlicast just doens't work because it is, for example, not enabled in the device kernel.

Another issue is that the WifiTranslation app lets the user transmit as easily as receive. This is fine for small groups of people or venues but for larger installations it is necessary to restrict who can transmit to prevent possible deliberate or accidental hijacking of a translation channel.

What it does (or will do)

The hub listens to all the translation channels and ensures that all except the intended translator can transmit for any given language. When the translation is received the hub relays the translation over a web interface that can be received on any device with a new enough web browser via http.

It can also print off a QR code and web address that people can use to get themselves connected. If they scan the QR code using an Android device it will trigger a link to the GooglePlay page for the Android app and if they don't have an Android phone then they get the web interface.

The http system of sending the audio is designed to be cache-friendly to reduce the load on the hub if, say, a cache such as Varnish is used. It would also be possible to serve the http audio over the WAN so that it doesn't even matter if they aren't on the LAN, although some kind of (future) security would be needed to prevent eavesdropping and access in any way to the admin interface.

How to use

Run wifitranslationhub.py, or install the Windows EXE and install from https://drive.google.com/drive/folders/1_LKzzSyZvYat5LHyWHS8v3t7mr4nhaLv?usp=sharing on the same LAN as the WifiTranslation multicast.

Go to http://localhost:8080/admin.html to see the admin interface. Then press the QR/URL button to discover the web address to use by devices to access the player.

Remember to initially unlock a channel before using it, otherwise the translator will not be able to send. Once the translator is sending, they can be added to the allowed list by right-clicking on their UUID and selecting the enable option.

It is recommended that the domain name "xlation.lan" resolves to the IP of the WifiTranslationHub server for the Android App to work with the hub. This may be set up in the DNS server settings local LAN gateway/router. It should still work otherwise since the hub also sends broadcast messages to advertise its presence to the Android app.

See the docs folder for more information

About

Hub for the Wifi Translation Android app to enable management and unicast web-player fallback

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published