{{>toc}}

h1. Install in Debian/Ubuntu

h2. From my repository

h3. Add my repository

<pre>
cat << EOF > /etc/apt/sources.list.d/cerbelle.list
deb [trusted=yes] https://packages.cerbelle.net/debian unstable/
deb-src [trusted=yes] https://packages.cerbelle.net/debian unstable/
EOF
</pre>

h3. Update your package list

<pre><code class="shell">
apt-get update
</code></pre>

h3. Install the package

<pre><code class="shell">
apt-get install rsstats
</code></pre>

h3. Uninstall and purge the package

<pre><code class="shell">
apt-get purge rsstats
</code></pre>

h2. Install from the DEB package file

h3. Download the package file

"rsstats_0.0.1-1_amd64.deb":https://packages.cerbelle.net/debian/unstable/rsstats_0.0.1-1_amd64.deb

h3. Install the package

<pre><code class="shell">
gdebi rsstats_0.0.1-1_amd64.deb
</code></pre>

or

<pre><code class="shell">
gdebi-gtk rsstats_0.0.1-1_amd64.deb
</code></pre>

or

<pre><code class="shell">
apt-get install libopts25 libssl3
dpkg -i rsstats_0.0.1-1_amd64.deb
</code></pre>

h3. Uninstall and purge the package

<pre><code class="shell">
dpkg -P rsstats
</code></pre>

h2. Use the AppImage

h3. Download the file

"rsstats-0.0.1-linux.AppImage":https://packages.cerbelle.net/rsstats/0.0.1/rsstats-0.0.1-linux.AppImage

h3. Make the file executable

<pre><code class="shell">
chmod +x rsstats-0.0.1-linux.AppImage
</code></pre>

h2. From the compiled ZIP archive (TODO)

h2. Build from the sources

h3. Install the mandatory build dependencies

<pre><code class="shell">
apt-get install build-essential libssl-dev pkg-config
</code></pre>

h3. Download the sources

"rsstats-0.0.1.tar.gz":https://packages.cerbelle.net/rsstats/0.0.1/rsstats-0.0.1.tar.gz

h3. Extract the archive

<pre><code class="shell">
tar xvzf rsstats-0.0.1.tar.gz
cd rsstats-0.0.1
</code></pre>

h3. Prepare the build

The default installation folder is @/usr/local@. You can add the standard @--prefix@ argument to change the default installation folder to another location, such as @--prefix=/opt/rsstats@, for example.
<pre><code class="shell">
./configure --disable-doxygen
</code></pre>

h3. Build & Check

<pre><code class="shell">
make clean all check
</code></pre>

h3. Install & Check

You can install with the provided system

<pre><code class="shell">
make install installcheck
</code></pre>

or you can build the DEB packages by yourself (you'll need to install @debuild@ from the _dev-scripts_ package or @dpkgbuildpackage@ from the _dpkg-dev_ package) and follow the previous steps to use them :

<pre><code class="shell">
make debian-deb
</code></pre>

h3. Remove the build folder (optional)

If you installed _rsstats_ in the system's root (@/@), You should keep the build dir because you can use @make uninstall@ to cleanly uninstall each installed file. If you installed _rsstats_ in its own folder, you'll be able to simply delete this folder and should not need the build dir anymore.

<pre><code class="shell">
cd ..
rm -Rf rsstats-0.0.1
</code></pre>

h3. Remove carefully the build dependencies (optional)

You can remove the build dependencies if they were not already installed when you requested them. Otherwise, another application is probably depending on them and you should probably not remove them. I suggest to keep them, but if you really want to remove them, please do only remove the dependencies which were not already installed before the first step.

<pre><code class="shell">
apt-get purge libssl-dev
apt-get purge build-essential pkg-config
</code></pre>

If you remove @libssl-dev@, you have to ensure that @libssl3@ remains installed (I hope that you already had it on your system).

<pre><code class="shell">
apt-get install libssl3
</code></pre>

h1. Usage

This tool is a commandline tool and the usage is the same in all the supported operating systems. [[Usage|Please continue with the usage documentation]].