{{>toc}}

h1. Install in MacOS

h2. From ZIP archive

h3. Download the file

"rsstats-0.0.1-macos.zip":https://packages.cerbelle.net/rsstats/0.0.1/rsstats-0.0.1-macos.zip

h3. Install

Unzip the archive with ditto :

<pre><code class="shell">
ditto -x rsstats-0.0.1-macos.zip
</code></pre>


or with the user interface by opening it.

I recommend either to move the folder in @/opt@ or at your home's root, using the command line in a terminal or drag'n dropping the folder and in the _Finder_ :

<pre><code class="shell">
sudo mv macosinst /opt/rsstats
</code></pre>

h3. Uninstall

Delete the folder.

h2. From DMG image

h3. Download the file

"rsstats-0.0.1-macos.dmg":https://packages.cerbelle.net/rsstats/0.0.1/rsstats-0.0.1-macos.dmg

h3. Install

Open/Mount the DMG Image in the _Finder_. Drag'n drop the inside folder in your home or in @/opt@. 

h3. Uninstall

Delete the folder.

h2. From PKG package

h3. Download the file

"rsstats-0.0.1-macos.pkg":https://packages.cerbelle.net/rsstats/0.0.1/rsstats-0.0.1-macos.pkg

h3. Install

Open the file in the _Finder_ or use the following command line in a terminal. Despite it is possible, I recommend not to install the package in the system's root. *+I recommend to install it in @/opt/rsstats@+* . It makes the uninstall easier and less risky for your whole MacOS system !

<pre><code class="shell">
installer -pkg rsstats-0.0.1-macos.pkg -target /opt/rsstats
</code></pre>

h3. Uninstall

Uninstalling a PKG is always tricky and can be challenging (if not dangerous for the MacOS System) depending on the installation location. Please read carefully, use a PKG uninstaller application or keep _rsstats_ installed.

First, get the package name (unique identifier) :

<pre><code class="shell">
pkgutil --pkgs | grep rsstats
</code></pre>

It should be _net.cerbelle.pkg.rsstats_. Then, get the installation location, with the package unique id :

<pre><code class="shell">
pkgutil --pkg-info net.cerbelle.pkg.rsstats
</code></pre>

If you installed _rsstats_ in a separate subfolder, such as @/opt/rsstats@, you can delete this folder @/opt/rsstats@ and skip the next two steps (file and folder deletion).

Otherwise, you need to delete each installed file from the list returned by the following command, but you need to check that each file can be safely removed (it belongs and is used *only* to/by _rsstats_.

<pre><code class="shell">
pkgutil --only-files --files net.cerbelle.pkg.rsstats
</code></pre>

Then, you need to do the same with the folders. *If you deployed the package in the root of the system (@/@), I do strongly recommand to not delete the folders.*

<pre><code class="shell">
pkgutil --only-dirs --files net.cerbelle.pkg.rsstats
</code></pre>

Finally, you can ask the system to forget that the package was installed and remove the package's meta-data.

<pre><code class="shell">
sudo pkgutil --forget net.cerbelle.pkg.rsstats
</code></pre>

h2. Build from the sources

h3. Install the mandatory build dependencies

h4. compilation toolchain

<pre><code class="shell">
xcode-select --install
</code></pre>

h4. HomeBrew

<pre><code class="shell">
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo >> /Users/fcerbell/.bash_profile
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> /Users/fcerbell/.bash_profile
eval "$(/usr/local/bin/brew shellenv)"
</code></pre>

h4. libssl headers

<pre><code class="shell">
brew install openssl@3 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 --prefix=/opt/rsstats
</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 DMG/PKG/ZIP packages by yourself and follow the previous steps to use them :

<pre><code class="shell">
make macos-zip macos-dmg macos-pkg
</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">
brew uninstall pkg-config                                                                                                                                                                                                                                          
</code></pre>

If you remove @openssl@3@, it will break _rsstats_ and probably your system, plesae do not.

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]].