• Table of contents
• Install in MacOS
  • From ZIP archive
    • Download the file
    • Install
    • Uninstall
  • From DMG image
    • Download the file
    • Install
    • Uninstall
  • From PKG package
    • Download the file
    • Install
    • Uninstall
  • Build from the sources
    • Install the mandatory build dependencies
      • compilation toolchain
      • HomeBrew
      • libssl headers
    • Download the sources
    • Extract the archive
    • Prepare the build
    • Build & Check
    • Install & Check
    • Remove the build folder (optional)
    • Remove carefully the build dependencies (optional)
• Usage

Install in MacOS¶

From ZIP archive¶

Download the file¶

rsstats-0.0.1-macos.zip

Install¶

Unzip the archive with ditto :

ditto -x rsstats-0.0.1-macos.zip

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 :

sudo mv macosinst /opt/rsstats

Uninstall¶

Delete the folder.

From DMG image¶

Download the file¶

rsstats-0.0.1-macos.dmg

Install¶

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

Uninstall¶

Delete the folder.

From PKG package¶

Download the file¶

rsstats-0.0.1-macos.pkg

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 !

installer -pkg rsstats-0.0.1-macos.pkg -target /opt/rsstats

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) :

pkgutil --pkgs | grep rsstats

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

pkgutil --pkg-info net.cerbelle.pkg.rsstats

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.

pkgutil --only-files --files net.cerbelle.pkg.rsstats

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.

pkgutil --only-dirs --files net.cerbelle.pkg.rsstats

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

sudo pkgutil --forget net.cerbelle.pkg.rsstats

Build from the sources¶

Install the mandatory build dependencies¶

compilation toolchain¶

xcode-select --install

HomeBrew¶

/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)" 

libssl headers¶

brew install openssl@3 pkg-config

Download the sources¶

rsstats-0.0.1.tar.gz

Extract the archive¶

tar xvzf rsstats-0.0.1.tar.gz
cd rsstats-0.0.1

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.

./configure --disable-doxygen --prefix=/opt/rsstats

Build & Check¶

make clean all check

Install & Check¶

You can install with the provided system

make install installcheck

or you can build the DMG/PKG/ZIP packages by yourself and follow the previous steps to use them :

make macos-zip macos-dmg macos-pkg

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.

cd ..
rm -Rf rsstats-0.0.1

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.

brew uninstall pkg-config                                                                                                                                                                                                                                          

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

Usage¶

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