Documentation for rss reader
This commit is contained in:
Bob Mottram
parent
458ffa8711
commit
74d24aa298
|
|
@ -25,6 +25,7 @@
|
|||
| [[Microblogging (GNU Social)]] |
|
||||
| [[Social Network]] |
|
||||
| [[Chat Services]] |
|
||||
| [[RSS Reader]] |
|
||||
|
||||
* Readme
|
||||
After the system has installed a README file will be generated which contains passwords and some brief advice on using the installed systems. You can read this with the following commands:
|
||||
|
|
@ -302,3 +303,30 @@ Freedombone also supports SIP phones The username and domain is the same as for
|
|||
Return to the <a href="index.html">home page</a>
|
||||
</center>
|
||||
#+END_HTML
|
||||
* RSS Reader
|
||||
If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen.
|
||||
|
||||
#+BEGIN_SRC bash
|
||||
ssh username@domainname -p 2222
|
||||
emacs README
|
||||
exit
|
||||
#+END_SRC
|
||||
|
||||
The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to.
|
||||
|
||||
To set up the system open http://rss_reader_onion_address/ and enter:
|
||||
|
||||
* Database type: MySQL
|
||||
* Username: root
|
||||
* Password: [MariaDB database root password]
|
||||
* Database name: ttrss
|
||||
* Host name: localhost
|
||||
* Port: 3306
|
||||
* Tiny Tint RSS URL: http://rss_reader_onion_address/
|
||||
|
||||
Click *Test configuration* and then *Initialize database*. You may need to click *Save configuration*.
|
||||
Initially log in with username *admin* and password *password*.
|
||||
|
||||
Then go to *Preferences/Users*, click on the *admin* user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
|
||||
|
||||
To access the RSS reader from a mobile device you can install a Tor compatible browser such as [[https://f-droid.org/wiki/page/info.guardianproject.orfox][OrFox]]. It will try to automatically change to the mobile version of the user interface, but if that doesn't work then navigate to http://rss_reader_onion_address/mobile.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
||||
<head>
|
||||
<!-- 2016-02-03 Wed 16:32 -->
|
||||
<!-- 2016-02-08 Mon 15:52 -->
|
||||
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<title></title>
|
||||
|
|
@ -205,6 +205,10 @@ for the JavaScript code in this tag.
|
|||
<tr>
|
||||
<td class="org-left"><a href="#orgheadline8">Chat Services</a></td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td class="org-left"><a href="#orgheadline9">RSS Reader</a></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
|
|
@ -322,9 +326,9 @@ Subsequently even if dynamic DNS isn't working you may still be able to administ
|
|||
<div id="outline-container-orgheadline4" class="outline-2">
|
||||
<h2 id="orgheadline4">Syncing to the Cloud</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline4">
|
||||
</div><div id="outline-container-orgheadline9" class="outline-3">
|
||||
<h3 id="orgheadline9">Initial install</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline9">
|
||||
</div><div id="outline-container-orgheadline10" class="outline-3">
|
||||
<h3 id="orgheadline10">Initial install</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline10">
|
||||
<p>
|
||||
Within a browser go to your owncloud domain, then create an administrator account. The username and password can be anything, and ideally should be generated from a password manager.
|
||||
</p>
|
||||
|
|
@ -368,9 +372,9 @@ Log out from the administrator account and then log back in as the user you just
|
|||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline10" class="outline-3">
|
||||
<h3 id="orgheadline10">On Android</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline10">
|
||||
<div id="outline-container-orgheadline11" class="outline-3">
|
||||
<h3 id="orgheadline11">On Android</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline11">
|
||||
<p>
|
||||
Within F-droid search for <b>owncloud</b> and install the client. Also install <b>CalDAV Sync Adapter</b>.
|
||||
</p>
|
||||
|
|
@ -394,9 +398,9 @@ You will also be prompted to enter login details. Your Android and Owncloud cale
|
|||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline11" class="outline-3">
|
||||
<h3 id="orgheadline11">On Linux</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline11">
|
||||
<div id="outline-container-orgheadline12" class="outline-3">
|
||||
<h3 id="orgheadline12">On Linux</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline12">
|
||||
<p>
|
||||
Open your software center and search for "owncloud client". Enter your owncloud domain name (with the https prefix) and login details.
|
||||
</p>
|
||||
|
|
@ -410,9 +414,9 @@ You can now drag files into the <b>~/owncloud</b> directory and they will automa
|
|||
<div id="outline-container-orgheadline5" class="outline-2">
|
||||
<h2 id="orgheadline5">Play Music</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline5">
|
||||
</div><div id="outline-container-orgheadline12" class="outline-3">
|
||||
<h3 id="orgheadline12">With the DLNA service</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline12">
|
||||
</div><div id="outline-container-orgheadline13" class="outline-3">
|
||||
<h3 id="orgheadline13">With the DLNA service</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline13">
|
||||
<p>
|
||||
An easy way to play music on any mobile device in your home is to use the DLNA service. Copy your music into a directory called "<i>Music</i>" on a USB thumb drive and then insert it into from socket on the Beaglebone.
|
||||
</p>
|
||||
|
|
@ -452,9 +456,9 @@ The DLNA service will only work within your local home network, and isn't remote
|
|||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-orgheadline13" class="outline-3">
|
||||
<h3 id="orgheadline13">With Owncloud</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline13">
|
||||
<div id="outline-container-orgheadline14" class="outline-3">
|
||||
<h3 id="orgheadline14">With Owncloud</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline14">
|
||||
<p>
|
||||
The main advantage of playing music via Owncloud is that you can do that from anywhere - not only within your home network.
|
||||
</p>
|
||||
|
|
@ -469,9 +473,9 @@ By default a music player is installed into Owncloud, so all you need to do is t
|
|||
<div id="outline-container-orgheadline6" class="outline-2">
|
||||
<h2 id="orgheadline6">Microblogging (GNU Social)</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline6">
|
||||
</div><div id="outline-container-orgheadline14" class="outline-3">
|
||||
<h3 id="orgheadline14">Initial configuration</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline14">
|
||||
</div><div id="outline-container-orgheadline15" class="outline-3">
|
||||
<h3 id="orgheadline15">Initial configuration</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline15">
|
||||
<p>
|
||||
To log into your GNU Social site first obtain your username and password from the "microblogging" section of the readme file.
|
||||
</p>
|
||||
|
|
@ -493,17 +497,17 @@ Navigate to your site and log in. You may then want to select <b>Admin</b> and c
|
|||
<div id="outline-container-orgheadline7" class="outline-2">
|
||||
<h2 id="orgheadline7">Social Network</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline7">
|
||||
</div><div id="outline-container-orgheadline15" class="outline-3">
|
||||
<h3 id="orgheadline15">Domains</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline15">
|
||||
</div><div id="outline-container-orgheadline16" class="outline-3">
|
||||
<h3 id="orgheadline16">Domains</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline16">
|
||||
<p>
|
||||
Both Hubzilla and GNU Social try to obtain certificates automatically at the time of installation via Let's Encrypt. This will likely mean that in order for this to work you'll need to have obtained at least one "official" domain via a domain selling service, since Let's Encrypt mostly doesn't seem to work with free subdomains from sites such as freeDNS.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline16" class="outline-3">
|
||||
<h3 id="orgheadline16">Initial install</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline16">
|
||||
<div id="outline-container-orgheadline17" class="outline-3">
|
||||
<h3 id="orgheadline17">Initial install</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline17">
|
||||
<p>
|
||||
Visit the URL of your Hubzilla site and you should be taken through the rest of the installation procedure. Note that this may take a few minutes so don't be concerned if it looks as if it has crashed - just leave it running.
|
||||
</p>
|
||||
|
|
@ -517,16 +521,16 @@ When installation is complete you can register a new user.
|
|||
<div id="outline-container-orgheadline8" class="outline-2">
|
||||
<h2 id="orgheadline8">Chat Services</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline8">
|
||||
</div><div id="outline-container-orgheadline17" class="outline-3">
|
||||
<h3 id="orgheadline17">IRC</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline17">
|
||||
</div><div id="outline-container-orgheadline18" class="outline-3">
|
||||
<h3 id="orgheadline18">IRC</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline18">
|
||||
<p>
|
||||
IRC is useful for multi-user chat. The classic use case is for software development where many engineers might need to coordinate their activities, but it's also useful for meetings, parties and general socialising.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline18" class="outline-4">
|
||||
<h4 id="orgheadline18">Irssi</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline18">
|
||||
<div id="outline-container-orgheadline19" class="outline-4">
|
||||
<h4 id="orgheadline19">Irssi</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline19">
|
||||
<p>
|
||||
If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then you can use the following commands to connect to your IRC server.
|
||||
</p>
|
||||
|
|
@ -540,9 +544,9 @@ If you are using the <a href="http://www.irssi.org/">irssi</a> IRC client then y
|
|||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline19" class="outline-4">
|
||||
<h4 id="orgheadline19">XChat</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline19">
|
||||
<div id="outline-container-orgheadline20" class="outline-4">
|
||||
<h4 id="orgheadline20">XChat</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline20">
|
||||
<p>
|
||||
If you are using the XChat client:
|
||||
</p>
|
||||
|
|
@ -578,12 +582,12 @@ Click <b>close</b> and then <b>connect</b>.
|
|||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-orgheadline25" class="outline-3">
|
||||
<h3 id="orgheadline25">XMPP/Jabber</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline25">
|
||||
</div><div id="outline-container-orgheadline20" class="outline-4">
|
||||
<h4 id="orgheadline20">Managing users</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline20">
|
||||
<div id="outline-container-orgheadline26" class="outline-3">
|
||||
<h3 id="orgheadline26">XMPP/Jabber</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline26">
|
||||
</div><div id="outline-container-orgheadline21" class="outline-4">
|
||||
<h4 id="orgheadline21">Managing users</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline21">
|
||||
<p>
|
||||
To add a user:
|
||||
</p>
|
||||
|
|
@ -642,9 +646,9 @@ prosodyctl status
|
|||
</div>
|
||||
</div>
|
||||
|
||||
<div id="outline-container-orgheadline21" class="outline-4">
|
||||
<h4 id="orgheadline21">Using with Jitsi</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline21">
|
||||
<div id="outline-container-orgheadline22" class="outline-4">
|
||||
<h4 id="orgheadline22">Using with Jitsi</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline22">
|
||||
<p>
|
||||
Jitsi is the recommended communications client for desktop or laptop systems, since it includes the <i>off the record</i> (OTR) feature which provides some additional security beyond the usual SSL certificates.
|
||||
</p>
|
||||
|
|
@ -674,9 +678,9 @@ You can also <a href="https://www.youtube.com/watch?v=vgx7VSrDGjk">see this vide
|
|||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline22" class="outline-4">
|
||||
<h4 id="orgheadline22">Using with Ubuntu</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline22">
|
||||
<div id="outline-container-orgheadline23" class="outline-4">
|
||||
<h4 id="orgheadline23">Using with Ubuntu</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline23">
|
||||
<p>
|
||||
The default XMPP client in Ubuntu is Empathy. Using Empathy isn't as secure as using Jitsi, since it doesn't include the <i>off the record</i> feature, but since it's the default it's what many users will have easy access to.
|
||||
</p>
|
||||
|
|
@ -694,17 +698,17 @@ Click on <b>Advanced</b> and make sure that <b>Encryption required</b> and <b>Ig
|
|||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline23" class="outline-4">
|
||||
<h4 id="orgheadline23">Using Tor Messenger</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline23">
|
||||
<div id="outline-container-orgheadline24" class="outline-4">
|
||||
<h4 id="orgheadline24">Using Tor Messenger</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline24">
|
||||
<p>
|
||||
Tor Messenger is a messaging client which supports XMPP, and its onion routing enables you to protect the metadata of chat interactions to some extent by making it difficult for an adversary to know which server is talking to which. You can download Tor Messenger from <a href="https://torproject.org/">torproject.org</a> and the setup is pretty simple.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline24" class="outline-4">
|
||||
<h4 id="orgheadline24">Using with Android</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline24">
|
||||
<div id="outline-container-orgheadline25" class="outline-4">
|
||||
<h4 id="orgheadline25">Using with Android</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline25">
|
||||
<p>
|
||||
Install <a href="https://f-droid.org/">F-Droid</a>
|
||||
</p>
|
||||
|
|
@ -731,16 +735,16 @@ Go back to the initial screen and then using the menu you can add contacts and b
|
|||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline26" class="outline-3">
|
||||
<h3 id="orgheadline26">Tox</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline26">
|
||||
<div id="outline-container-orgheadline27" class="outline-3">
|
||||
<h3 id="orgheadline27">Tox</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline27">
|
||||
<p>
|
||||
Tox is an encrypted peer-to-peer messaging system and so should work without Freedombone. It uses a system of nodes which act as a sort of directory service allowing users to find and connect to each other. The Tox node ID on the Freedombone can be found within the README within your home directory. If you have other users connect to your node then you will be able to continue chatting even when no other nodes are available.
|
||||
</p>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline27" class="outline-4">
|
||||
<h4 id="orgheadline27">Using the Toxic client</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline27">
|
||||
<div id="outline-container-orgheadline28" class="outline-4">
|
||||
<h4 id="orgheadline28">Using the Toxic client</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline28">
|
||||
<p>
|
||||
To connect to your node use the command:
|
||||
</p>
|
||||
|
|
@ -753,12 +757,12 @@ To connect to your node use the command:
|
|||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline30" class="outline-3">
|
||||
<h3 id="orgheadline30">VoIP (Voice chat)</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline30">
|
||||
</div><div id="outline-container-orgheadline28" class="outline-4">
|
||||
<h4 id="orgheadline28">Using with Ubuntu</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline28">
|
||||
<div id="outline-container-orgheadline31" class="outline-3">
|
||||
<h3 id="orgheadline31">VoIP (Voice chat)</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline31">
|
||||
</div><div id="outline-container-orgheadline29" class="outline-4">
|
||||
<h4 id="orgheadline29">Using with Ubuntu</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline29">
|
||||
<p>
|
||||
Within the software center search for "mumble" and install the client then run it. Skip through the audio setup wizard.
|
||||
</p>
|
||||
|
|
@ -772,9 +776,9 @@ Click on "add new" to add a new server and enter the default domain name for the
|
|||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline29" class="outline-4">
|
||||
<h4 id="orgheadline29">Using with Android</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline29">
|
||||
<div id="outline-container-orgheadline30" class="outline-4">
|
||||
<h4 id="orgheadline30">Using with Android</h4>
|
||||
<div class="outline-text-4" id="text-orgheadline30">
|
||||
<p>
|
||||
Install <a href="https://f-droid.org/">F-Droid</a>
|
||||
</p>
|
||||
|
|
@ -801,9 +805,9 @@ Selecting the server by pressing on it then connects you to the server so that y
|
|||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline31" class="outline-3">
|
||||
<h3 id="orgheadline31">SIP phones</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline31">
|
||||
<div id="outline-container-orgheadline32" class="outline-3">
|
||||
<h3 id="orgheadline32">SIP phones</h3>
|
||||
<div class="outline-text-3" id="text-orgheadline32">
|
||||
<p>
|
||||
Freedombone also supports SIP phones The username and domain is the same as for your email address, and the SIP password and extension number will appear within the README file in your home directory. Various SIP client options are available, such as CSipSimple on Android and Jitsi on desktop or laptop machines. Ideally use clients which support ZRTP, which will provide the best level of security.
|
||||
</p>
|
||||
|
|
@ -814,6 +818,53 @@ Return to the <a href="index.html">home page</a>
|
|||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="outline-container-orgheadline9" class="outline-2">
|
||||
<h2 id="orgheadline9">RSS Reader</h2>
|
||||
<div class="outline-text-2" id="text-orgheadline9">
|
||||
<p>
|
||||
If you check the readme file within your home directory then you will be able to find out the onion address for the RSS reader which exists on most variants of Freedombone. The address can also be found on the control panel About screen.
|
||||
</p>
|
||||
|
||||
<div class="org-src-container">
|
||||
|
||||
<pre class="src src-bash">ssh username@domainname -p 2222
|
||||
emacs README
|
||||
<span class="org-keyword">exit</span>
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
<p>
|
||||
The RSS reader is accessible only via an onion address. This provides a reasonable degree of reading privacy, making it difficult for passive adversaries such as governments or corporations to create lists of sites which you are subscribed to.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
To set up the system open <a href="http://rss_reader_onion_address/">http://rss_reader_onion_address/</a> and enter:
|
||||
</p>
|
||||
|
||||
<ul class="org-ul">
|
||||
<li>Database type: MySQL</li>
|
||||
<li>Username: root</li>
|
||||
<li>Password: [MariaDB database root password]</li>
|
||||
<li>Database name: ttrss</li>
|
||||
<li>Host name: localhost</li>
|
||||
<li>Port: 3306</li>
|
||||
<li>Tiny Tint RSS URL: <a href="http://rss_reader_onion_address/">http://rss_reader_onion_address/</a></li>
|
||||
</ul>
|
||||
|
||||
<p>
|
||||
Click <b>Test configuration</b> and then <b>Initialize database</b>. You may need to click <b>Save configuration</b>.
|
||||
Initially log in with username <b>admin</b> and password <b>password</b>.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
Then go to <b>Preferences/Users</b>, click on the <b>admin</b> user and then change the password. You will immediately see what looks like an authorisation error, so log out and log back in with username "admin" and your new password.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
To access the RSS reader from a mobile device you can install a Tor compatible browser such as <a href="https://f-droid.org/wiki/page/info.guardianproject.orfox">OrFox</a>. It will try to automatically change to the mobile version of the user interface, but if that doesn't work then navigate to <a href="http://rss_reader_onion_address/mobile">http://rss_reader_onion_address/mobile</a>.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div id="postamble" class="status">
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue