-
Notifications
You must be signed in to change notification settings - Fork 103
Quickstart Guide
You must be running a sufficiently recent version of weechat for this application to work. You can check the version you currently have by running /version in weechat server buffer. Anything newer than 0.3.7 should work.
Note: Support for highlights in irc/other buffers is only supported if you are running 0.3.8-dev compiled after March 6th. See upstream commit for details: http://git.savannah.gnu.org/gitweb/?p=weechat.git;a=commit;h=d495c419197c670e8649853b580e39fff0162617
This app is built to target Android devices running Android 2.1 or higher. I have personally tested it on Android 2.3.3, but have heard reports of it working on other devices. If it works fine on your device, add it to the list below:
Tested devices:
- Samsung Epic 4G(Not the touch) – Android 2.3.3 - Works fine.
- Android Emulator - Android 2.1 – Works fine.
- Samsung / Google Galaxy Nexus – Works fine.
Since this relies on the relay plugin built into weechat, we need to configure it first. The following is the help message for the relay plugin in 0.3.8-rc2.
[relay] /relay list|listfull|listrelay
add <protocol.name> <port>
del <protocol.name>
raw
relay control
list: list relay clients (only active relays)
listfull: list relay clients (verbose, all relays)
listrelay: list relays (name and port)
add: add relay for a protocol + name
del: remove relay for a protocol + name
protocol.name: protocol and name to relay:
- protocol "irc": name is the server to share
- protocol "weechat" (name is not used)
port: port used for relay
raw: open buffer with raw Relay data
Without argument, this command opens buffer with list of relay clients.
Examples:
irc proxy, for server "freenode":
/relay add irc.freenode 8000
weechat protocol:
/relay add weechat 8001
We will be adding a relay server using the weechat protocol, and we'll stick to the port suggested in the example. So run the command:
/relay add weechat 8001
relay: listening on port 8001 (relay: weechat, max 5 clients)
relay: relay "weechat" (port 8001) added
Now that it is listening, we should set a password for it, replacing "your-secret-password" with your chosen password. Note: Connections with weechat are not encrypted, so in theory an evesdropper can intercept your password and any other communications sent.
/set relay.network.password "your-secret-password"
###A note about firewalls Since weechat is now listening for connections on port 8001, you need to make sure your firewall is setup to allow that port. If you are behind a router you will need to configure port forwarding. This is beyond the scope of this guide however.
The first thing you must do is enable installation of applications that come from outside the Android Market. To do this, under settings, choose Applications, then check the box "Unknown Sources".
Navigate to the main download page, or snap the QR code with a barcode scanner to download the apk file. Once it finishes downloading, tap on it and it will prompt you to install. Once installation completes, you can choose to open the app.
The first time you run the app, you will need to configure it. Press Menu, then Preferences.
- Relay Host - Set this to the ip address/hostname of the machine where weechat is running
- Relay Port - Set this to the port the weechat relay server is listening on, if you're following along it should be 8001.
- Relay Password - The password you configured for the connection in weechat earlier.
You may wish to change some of the other preferences at this time as well. Once you leave the preferences page, press Menu, then Connect. If everything was configured successfully you should be looking at a list of all the buffers you have open in weechat.
I hope this application can be useful for you, I use it almost daily for keeping up with conversations from my phone. If you have any feature requests or bug reports, please feel free to email me or create an issue on github.
###Troubleshooting If you run into any problems getting this to work, please let me know. You can create an issue on github, send me an email, or join me on irc(See below for details)
Email - [email protected]
irc - nick:ubergeek42 in #weechat on freenode