Latest revision |
Your text |
Line 1: |
Line 1: |
| JPush provides a way for information to be pushed to a device or computer. It provides 'hooks' on the server that cause 'actions' to be performed on the device, such as checking for new email. | | JPush provides a way for information to be pushed to a device or computer. It provides 'hooks' on the server that cause 'actions' to be performed on the device, such as checking for new email. |
| | | |
- | One common use is to get push email on a [[Nokia N900|N900]] device. | + | One common use is to get push email on a n900 device. |
| | | |
- | ==How it Works== | + | ===How it Works=== |
| + | JPush utilizes an existing XMPP (Jabber) connection to communicate with a device. The client adds the server as a 'buddy' using any existing jabber account on the n900. |
| | | |
- | JPush utilizes an existing XMPP (Jabber) connection to communicate with a device. The client adds the server as a 'buddy' using any existing jabber account on the N900.
| + | ===Installation=== |
- | | + | Coming Soon |
- | ==Setup== | + | |
- | | + | |
- | ===Pre-Setup===
| + | |
- | | + | |
- | * Create jabber account separate from your own (anywhere works, gmail, jabber.org, etc).
| + | |
- | * Add server account to buddy list of client account.
| + | |
- | * Modest must be set to check for new email automatically (just set it to once every 24 hours). This is some odd issue that I ran into.
| + | |
- | * Install the following files as instructed below.
| + | |
- | | + | |
- | ===Install===
| + | |
- | | + | |
- | *Server: a .deb file is available [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here].
| + | |
- | *Client (N900): a .deb is not available yet. Download the source code from [https://garage.maemo.org/frs/?group_id=1903&release_id=4168 here], and install the files in any directory. Make sure the files are executable (<code>chmod +x</code>).
| + | |
- | | + | |
- | ===Configuration===
| + | |
- | | + | |
- | ====Server====
| + | |
- | | + | |
- | # Edit <code>/usr/bin/jpush-server</code>
| + | |
- | #* edit the config block:
| + | |
- | #** insert username and password for a new jabber account created above.
| + | |
- | #** set a secret that you will also put on the client (make this up).
| + | |
- | #** set notifications (type of commands to be sent to the device). Leave this as the default if you only want email.
| + | |
- | # Setup Email Hook
| + | |
- | #* <code>/usr/bin/jpush-emailhook</code> should be called whenever a new email is received. This sends an update to JPushServer, which notifies the N900.
| + | |
- | #* This file receives two arguments: <code>/usr/bin/jpush-emailhook username updateType</code>
| + | |
- | #** example: To receive push email, insert new line into <code>/etc/aliases</code> as: <pre>part-of-email-before-at-symbol "|/usr/bin/jpush-emailhook username email"</pre>
| + | |
- | #** Run '<code>sudo newaliases</code>' to make server update email config above.
| + | |
- | #** Forward all email to part-of-email-before-at-symbol@server.com
| + | |
- | # Starting
| + | |
- | #* Run jpush-server start
| + | |
- | | + | |
- | ====Client====
| + | |
- | | + | |
- | # Edit <code>/opt/jpush/jpush.py</code>
| + | |
- | #* edit the config block
| + | |
- | #** set a secret (use the same value that you set for the server config above).
| + | |
- | # Optional - Edit <code>/?/?/actions.py</code>
| + | |
- | #* Follow instructions in file.
| + | |
- | | + | |
- | ==Download==
| + | |
| | | |
| + | ===Download=== |
| https://garage.maemo.org/projects/jpush/ | | https://garage.maemo.org/projects/jpush/ |
- |
| |
- | [[Category:Software]]
| |
- | [[Category:Fremantle]]
| |