Usage

You control pxvoid through the commandline. There is a small helper tool in the /tools/ folder. You can use pxvoid.py to upload and delete pictures on your running pxvoid service.

pxvoid need the external Python library requests. There are varoius ways to provide them.

On debian and other regular Linux distributions, requests can be installed via pip install:

pip install requests

Next we need to export two shell variables:

export PXVOID_TOKEN='yoursupersafeuploadtoken'
export PXVOID_BASE_URL=https://pxvoid.your-domain.tld

Once thats's done, you can start uploading pictures

On NixOS you either create a virtual environment and then install requests via pip install:

python3 -m venv pxvoid
source pxvoid/bin/activate
pip install requests

or via nix-shell (you can find shell.nix in the pxvoid repository under /tools/shell.nix):

{pkgs ? import <nixpkg> {} }:

pkgs.mkShell {
    packages = [
        (pkgs.python3.withPackages (ps: with ps; [
            requests
            pip
        ]))
    ];
}

We also need to export the shell variables:

export PXVOID_TOKEN='yoursupersafeuploadtoken'
export PXVOID_BASE_URL=https://pxvoid.your-domain.tld

after that you can simply start the shell via nix-shell and use the tool directly.

Upload pictures

To upload pictures you can use the following command:

python pxvoid.py upload /path/to/picture.jpg --tags building,art,blackwhite

If everything works, you will receive a meesage that the image was successfully uploaded.

Delete pictures

If you want to delete pictures from your pxvoid gallery you can use the same tool with the delete flag:

python pxvoid.py delete 12

The id is the picture id given by pxvoid. Go to your gallery open the picture you want to delete and you will find the id in the url.