dar-backup 0.6.20.1__py3-none-any.whl → 0.7.1__py3-none-any.whl

{dar_backup-0.6.20.1.dist-info → dar_backup-0.7.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 0.6.20.1
+Version: 0.7.1
 Summary: A script to do full, differential and incremental backups using dar.     Some files are restored from the backups during verification, after which par2 redundancy files are created.     The script also has a cleanup feature to remove old backups and par2 files.
 Project-URL: GPG Public Key, https://keys.openpgp.org/search?q=dar-backup@pm.me
 Project-URL: Homepage, https://github.com/per2jensen/dar-backup/tree/main/v2
@@ -691,41 +691,51 @@ Classifier: Topic :: System :: Archiving :: Backup
 Requires-Python: >=3.9
 Requires-Dist: argcomplete>=3.6.2
 Requires-Dist: inputimeout>=1.0.4
+Requires-Dist: jinja2>=3.1.6
 Requires-Dist: rich>=13.0.0
 Description-Content-Type: text/markdown
 
 <!-- markdownlint-disable MD024 -->
-# Full, differential or incremental backups using 'dar'
+# `dar-backup`
+
+**Reliable DAR backups, automated in clean Python**
 
 [![codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
-[![PyPI monthly downloads](https://img.shields.io/pypi/dm/dar-backup)](https://pypi.org/project/dar-backup/)
-[![Total Downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=Total%20Downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+![CI](https://github.com/per2jensen/dar-backup/actions/workflows/py-tests.yml/badge.svg)
+[![PyPI version](https://img.shields.io/pypi/v/dar-backup.svg)](https://pypi.org/project/dar-backup/)
+[![PyPI total Downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=Total%20Downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+[![# clones](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/badge_clones.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
+[![Milestone](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/milestone_badge.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 
 The wonderful 'dar' [Disk Archiver](https://github.com/Edrusb/DAR) is used for
-the heavy lifting, together with the par2 suite in these scripts.
+the heavy lifting, together with [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
 
-This is the `Python` based **version 2** of `dar-backup`.
+This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-backup/tree/main/v2) of `dar-backup`.
 
 ## TL;DR
 
-`dar-backup` is a Python-powered CLI for creating and validating full, differential, and incremental backups using dar and par2. Designed for long-term restore integrity, even on user-space filesystems like FUSE.
+`dar-backup` is a Python-powered CLI for creating and validating full, differential, and incremental backups using `dar` and `par2`. Designed for long-term restore integrity, even on user-space filesystems like FUSE.
 
 ## Table of Contents
 
-- [Full, differential or incremental backups using 'dar'](#full-differential-or-incremental-backups-using-dar)
+- [Reliable `dar` backups wrapped in Python](#dar-backup)
 - [My use case](#my-use-case)
+- [Features](#features)
 - [License](#license)
+- [Changelog version 2](https://github.com/per2jensen/dar-backup/blob/main/v2/Changelog.md)
+- [Quick Guide](#quick-guide)
 - [Status](#status)
   - [GPG Signing key](#gpg-signing-key)
   - [Breaking change in version 0.6.0](#breaking-change-in-version-060)
 - [Homepage - Github](#homepage---github)
+- [Community](#community)
 - [Requirements](#requirements)
 - [Principles](#dar-backup-principles)
 - [How to run](#how-to-run)
   - [1 - installation](#1---installation)
   - [2 - configuration](#2---configuration)
   - [3 - generate catalog databases](#3---generate-catalog-databases)
-  - [4 - do FULL backups](#4---do-full-backups)
+  - [4 - give `dar-backup` a spin](#4---give-dar-backup-a-spin)
   - [5 - deactivate venv](#5---deactivate-venv)
 - [Config](#config)
   - [Config file](#config-file)
@@ -739,8 +749,7 @@ This is the `Python` based **version 2** of `dar-backup`.
 - [List contents of an archive](#list-contents-of-an-archive)
 - [dar file selection examples](#dar-file-selection-examples)
   - [Select a directory](#select-a-directory)
-  - [Select file dates in the directory](#select-file-dates-in-the-directory)
-  - [Exclude .xmp files from that date](#exclude-xmp-files-from-that-date)
+  - [Include and exclude some file](#select-files-with-z50-in-the-file-name-and-exclude-xmp-files)
 - [Restoring](#restoring)
   - [Default location for restores](#default-location-for-restores)
   - [--restore-dir option](#--restore-dir-option)
@@ -760,6 +769,7 @@ This is the `Python` based **version 2** of `dar-backup`.
   - [Separate log file for command output](#separate-log-file-for-command-output)
   - [Skipping cache directories](#skipping-cache-directories)
   - [Progress bar + current directory](#progress-bar-and-current-directory)
+  - [Shell Autocompletion](#shell-autocompletion)
 - [Todo](#todo)
 - [Known Limitations / Edge Cases](#known-limitations--edge-cases)
 - [Reference](#reference)
@@ -769,31 +779,274 @@ This is the `Python` based **version 2** of `dar-backup`.
   - [manager](#manager-options)
   - [cleanup](#cleanup-options)
   - [clean-log](#clean-log-options)
-  - [installer](#installer-options)
-  - [dar-backup-systemd](#dar-backup-systemd)
+  - [dar-backup-systemd](#dar-backup-systemd-options)
+  - [Installer](#installer-options)
+  - [demo](#demo-options)
   
 ## My use case
 
-I have cloud storage mounted on a directory within my home dir. The filesystem is [FUSE based](https://www.kernel.org/doc/html/latest/filesystems/fuse.html), which gives it a few special features
+I needed the following:
 
-- a non-privileged user can perform a mount
-- a privileged user cannot look into the filesystem --> a backup script running as root is not suitable
+- Backup my workstation to a remote server
+- Backup primarily photos, home made video and different types of documents
+- I have cloud storage mounted on a directory within my home dir. The filesystem is [FUSE based](https://www.kernel.org/doc/html/latest/filesystems/fuse.html), which gives it a few special features
 
- I needed the following:
+  - Backup cloud storage (cloud is convenient, but I want control over my backups)
+  - A non-privileged user can perform a mount
+  - A privileged user cannot look into the filesystem --> a backup script running as root is not suitable
 
-- Backup my cloud storage to something local (cloud is convenient, but I want control over my backups)
-- Backup primarily photos, video and different types of documents
-- Have a simple non-complicated way of restoring, possibly years into the future. 'dar' fits that scenario with a single statically linked binary (kept with the archives). There is no need install/configure anything - restoring is simple and works well.
+- Have a simple way of restoring, possibly years into the future. 'dar' fits that scenario with a single statically linked binary (kept with the archives). There is no need install/configure anything - restoring is simple and works well.
 - During backup archives must be tested and a restore test (however small) performed
 - Archives stored on a server with a reliable file system (easy to mount a directory over sshfs)
 - Easy to verify archive's integrity, after being moved around.
 
  I do not need the encryption features of dar, as all storage is already encrypted.
 
+## Features
+
+- The battle tested [dar](https://github.com/Edrusb/DAR) Disk Archiver is used for the actual backups - it comes highly recommended.
+- Backup with test of backup and (configurable) restore tests of files with comparison to source
+- [Redundancy files](#par2) created for patching bitrot of the archives (size configurable)
+- Simple [backup definitions](#backup-definition-example) defining what to backup (as many as you need)
+- [Backup catalogs](#dar-manager-databases) in databases, optionally on a disk different from the backups
+- Flexible and precise logging
+- Bash and zsh shell autocompletion for a nice CLI experience, [available completions](#shell-autocompletion):
+  
+  - Options for `dar-backup`, `cleanup`, `manager`
+  - Backup definitions
+  - Archives - filtered to backup definition if given
+  - Catalogs - filtered to backup definition if given
+
+- `dar-backup` is easy to install and configure.
+
+- ✅ The author has used dar-backup since > 4 years, and has been saved multiple times.
+
 ## License
 
   These scripts are licensed under the GPLv3 license.
-  Read more here: [GNU CPL 3.0](https://www.gnu.org/licenses/gpl-3.0.en.html), or have a look at the ["LICENSE"](https://github.com/per2jensen/dar-backup/blob/main/LICENSE) file in this repository.
+  Read more here: [GNU  GPL3.0](https://www.gnu.org/licenses/gpl-3.0.en.html), or have a look at the ["LICENSE"](https://github.com/per2jensen/dar-backup/blob/main/LICENSE) file in this repository.
+
+## Quick Guide
+
+This purpose of this quick guide is to show how `dar-backup` works in a few simple steps.
+
+The package include a `demo`application, that can help you set up `dar-backup` quickly.
+
+> ⚠️ **Assumption**
+>
+> The demo program uses these directories in your home directory:
+>
+> - $HOME/dar-backup
+> - $HOME/.config/dar-backup
+>
+> It is assumed they **do not exist** before running the demo.
+>
+> Python **>= 3.9** is required
+
+<br>
+
+**Let's roll** with installation, backup, list backup content, restore & restore check
+
+The demo is known to work on an Ubuntu 24.04 clean VM as delivered from `Multipass`
+
+```bash
+sudo apt -y install dar par2 python3 python3-venv
+INSTALL_DIR=/tmp/dar-backup
+mkdir "$INSTALL_DIR"
+cd "$INSTALL_DIR"
+python3 -m venv venv    # create the virtual environment 
+. venv/bin/activate     # activate the virtual environment
+pip install dar-backup  # run pip to install `dar-backup` into the virtual environment
+```
+
+<details>
+
+<summary>🎯 Install details</summary>
+
+```bash
+(venv) $ INSTALL_DIR=/tmp/dar-backup
+mkdir "$INSTALL_DIR"
+cd "$INSTALL_DIR"
+python3 -m venv venv    # create the virtual environment 
+. venv/bin/activate     # activate the virtual environment
+pip install dar-backup  # run pip to install `dar-backup`
+Collecting dar-backup
+  Downloading dar_backup-0.6.21-py3-none-any.whl.metadata (88 kB)
+     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 88.5/88.5 kB 3.7 MB/s eta 0:00:00
+Collecting argcomplete>=3.6.2 (from dar-backup)
+  Using cached argcomplete-3.6.2-py3-none-any.whl.metadata (16 kB)
+Collecting inputimeout>=1.0.4 (from dar-backup)
+  Using cached inputimeout-1.0.4-py3-none-any.whl.metadata (2.2 kB)
+Collecting rich>=13.0.0 (from dar-backup)
+  Using cached rich-14.0.0-py3-none-any.whl.metadata (18 kB)
+Collecting markdown-it-py>=2.2.0 (from rich>=13.0.0->dar-backup)
+  Using cached markdown_it_py-3.0.0-py3-none-any.whl.metadata (6.9 kB)
+Collecting pygments<3.0.0,>=2.13.0 (from rich>=13.0.0->dar-backup)
+  Using cached pygments-2.19.1-py3-none-any.whl.metadata (2.5 kB)
+Collecting mdurl~=0.1 (from markdown-it-py>=2.2.0->rich>=13.0.0->dar-backup)
+  Using cached mdurl-0.1.2-py3-none-any.whl.metadata (1.6 kB)
+Downloading dar_backup-0.6.21-py3-none-any.whl (101 kB)
+   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 101.9/101.9 kB 16.2 MB/s eta 0:00:00
+Using cached argcomplete-3.6.2-py3-none-any.whl (43 kB)
+Using cached inputimeout-1.0.4-py3-none-any.whl (4.6 kB)
+Using cached rich-14.0.0-py3-none-any.whl (243 kB)
+Using cached markdown_it_py-3.0.0-py3-none-any.whl (87 kB)
+Using cached pygments-2.19.1-py3-none-any.whl (1.2 MB)
+Using cached mdurl-0.1.2-py3-none-any.whl (10.0 kB)
+Installing collected packages: pygments, mdurl, inputimeout, argcomplete, markdown-it-py, rich, dar-backup
+Successfully installed argcomplete-3.6.2 dar-backup-0.6.21 inputimeout-1.0.4 markdown-it-py-3.0.0 mdurl-0.1.2 pygments-2.19.1 rich-14.0.0
+```
+
+</details>
+
+Setup the demo configurations and show a few operations
+
+<br>
+
+```bash
+# see reference section for options tweaking the install
+demo --install
+
+# create catalog database
+manager --create-db
+
+# do a FULL backup of the installed backup definition called `demo`
+dar-backup --full-backup  
+
+# list the contents of the backup
+dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+```
+
+<details>
+
+<summary>🎯 --list details</summary>
+
+```bash
+(venv) $ demo --install
+Directories created.
+File generated at '/home/user/.config/dar-backup/backup.d/demo'
+File generated at '/home/user/.config/dar-backup/dar-backup.conf'
+1. Now run `manager --create-db` to create the catalog database.
+2. Then you can run `dar-backup --full-backup` to create a backup.
+3. List backups with `dar-backup --list`
+4. List contents of a backup with `dar-backup --list-contents <backup-name>`
+
+
+
+(venv) $ manager --create-db 
+========== Startup Settings ==========
+manager.py:     0.7.1
+Config file:    /home/user/.config/dar-backup/dar-backup.conf
+Logfile:        /home/user/dar-backup/dar-backup.log
+dar_manager:    /home/user/.local/dar/bin/dar_manager
+dar_manager v.: 1.9.0
+======================================
+
+
+
+(venv) $ dar-backup --full-backup
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+======================================
+
+
+
+(venv) $ dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+======================================
+[Saved][-]       [-L-][  49%][ ]  drwx------   user user  8 kio Sat May 17 13:13:59 2025  .config
+[Saved][-]       [-L-][  49%][ ]  drwxrwxr-x   user user  8 kio Tue May  6 20:55:40 2025  .config/dar-backup
+[Saved][-]       [-L-][  48%][ ]  drwxrwxr-x   user user  6 kio Sat May 17 13:26:21 2025  .config/dar-backup/backup.d
+[Saved][ ]       [-L-][  40%][ ]  -rw-rw-r--   user user  764 o Sun Feb 23 21:23:01 2025  .config/dar-backup/backup.d/media-files
+[Saved][ ]       [-L-][  41%][ ]  -rw-rw-r--   user user  933 o Sun Feb 23 21:23:15 2025  .config/dar-backup/backup.d/pCloudDrive
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  1 kio Sun Mar 16 10:40:29 2025  .config/dar-backup/backup.d/test
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  824 o Tue May 13 17:00:52 2025  .config/dar-backup/backup.d/default
+[Saved][ ]       [-L-][  48%][ ]  -rw-rw-r--   user user  1 kio Sat May  3 10:40:33 2025  .config/dar-backup/backup.d/user-homedir
+[Saved][ ]       [-L-][  54%][ ]  -rw-rw-r--   user user  1 kio Sat May 17 18:17:40 2025  .config/dar-backup/backup.d/demo
+[Saved][ ]       [-L-][  55%][ ]  -rw-rw-r--   user user  1 kio Sat May 17 18:17:40 2025  .config/dar-backup/dar-backup.conf
+```
+
+</details>
+
+<br>
+
+Perform a restore and show the restored files
+
+```bash
+# restore all files in the backup
+dar-backup --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)  --verbose
+
+# prove the files have been restored to directory as configured
+find $HOME/dar-backup/restore
+```
+
+<details>
+
+<summary>🎯 --restore details</summary>
+
+```bash
+(venv) $ dar-backup --verbose --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+========== Startup Settings ==========
+dar-backup.py:    0.7.1
+dar path:         /home/user/.local/dar/bin/dar
+dar version:      2.7.17
+Script directory: /home/user/git/dar-backup/v2/src/dar_backup
+Config file:      /home/user/.config/dar-backup/dar-backup.conf
+.darrc location:  /home/user/git/dar-backup/v2/src/dar_backup/.darrc
+Backup.d dir:     /home/user/.config/dar-backup/backup.d
+Backup dir:       /home/user/dar-backup/backups
+Restore dir:      /home/user/dar-backup/restore
+Logfile location: /home/user/dar-backup/dar-backup.log
+PAR2 enabled:     True
+--do-not-compare: False
+======================================
+
+
+
+(venv) $ find ~/dar-backup/restore/
+/home/user/dar-backup/restore/
+/home/user/dar-backup/restore/.config
+/home/user/dar-backup/restore/.config/dar-backup
+/home/user/dar-backup/restore/.config/dar-backup/backup.d
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/media-files
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/pCloudDrive
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/test
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/default
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/user-homedir
+/home/user/dar-backup/restore/.config/dar-backup/backup.d/demo
+/home/user/dar-backup/restore/.config/dar-backup/dar-backup.conf
+```
+
+</details>
+
+<br>
+
+> ✅ **Next steps**
+>
+> Tinker with `demo's` options:
+>
+> - --root-dir      (perhaps $HOME)
+> - --dir-to-backup (perhaps Pictures)
+> - --backup-dir    (perhaps /media/user/big-disk)
+>
+> See log file: `cat "$HOME/dar-backup/dar-backup.log"`
+>
+> Checkout [systemd timers and services](#generate-systemd-files)
+>
+> Checkout [shell autocompletion (very nice !)](#shell-autocompletion)
+>
+> Checkout the [reference section](#reference)
 
 ## Status
 
@@ -805,9 +1058,13 @@ As of February 13, 2025, I have changed the status from alpha --> beta, as the f
 
 To increase the security and authenticity of dar-backup packages, all releases from v2-beta-0.6.18 onwards will be digitally signed using the GPG key below.
 
-🔐 GPG Signing Key Details
+<br>
 
-```` text
+<details>
+
+<summary>🎯 GPG Signing Key Details</summary>
+
+```text
 Name:        Per Jensen (author of dar-backup)
 Email:       dar-backup@pm.me
 Primary key: 4592 D739 6DBA EFFD 0845  02B8 5CCE C7E1 6814 A36E
@@ -816,9 +1073,13 @@ Created:     2025-03-29
 Expires:     2030-03-28
 Key type:    ed25519 (primary, SC)  
 Subkeys:     ed25519 (S), ed25519 (A), cv25519 (E)
-````
+```
 
-🔏 Where to Find Release Signatures
+<br>
+
+<details>
+
+<summary>🎯 Where to Find Release Signatures</summary>
 
 PyPI does *Not* host .asc Signature Files
 
@@ -826,7 +1087,7 @@ Although the `dar-backup` packages on PyPI are GPG-signed, PyPI itself does **no
 
 Therefore, you will not find `.asc` files on PyPI.
 
-✅ Where to Get `.asc` Signature Files
+**Where to Get `.asc` Signature Files**
 
 You can always download the signed release artifacts and their `.asc` files from the official GitHub Releases page:
 
@@ -842,43 +1103,55 @@ Each release includes:
 
 - `dar_backup-x.y.z-py3-none-any.whl.asc`
 
-🔐 How to Verify a Release from GitHub
+</details>
+
+<br>
+
+<details>
+
+<summary>🎯 How to Verify a Release from GitHub</summary>
 
 1. Import the GPG public key:
 
-   ```` bash
+   ```bash
    curl https://keys.openpgp.org/vks/v1/by-fingerprint/4592D7396DBAEFFD084502B85CCEC7E16814A36E | gpg --import
-   ````
+   ```
 
 2. Download the wheel or tarball and its .asc signature from the GitHub.
 
 3. Run GPG to verify it:
 
-   ```` bash
+   ```bash
    gpg --verify dar_backup-x.y.z.tar.gz.asc dar_backup-x.y.z.tar.gz
    # or
    gpg --verify dar_backup-x.y.z-py3-none-any.whl.asc dar_backup-x.y.z-py3-none-any.whl
-   ````
+   ```
 
 4. If the signature is valid, you'll see:
 
-   ```` text
+   ```text
    gpg: Good signature from "Per Jensen (author of dar-backup) <dar-backup@pm.me>"
-   ````
+   ```
 
 🛡️ Reminder: Verify the signing subkey
 
 Only this subkey is used to sign PyPI packages:
 
-```` text
+```text
 B54F 5682 F28D BA36 22D7  8E04 58DB FADB BBAC 1BB1
-````
+```
 
 You can view it with:
 
-```` bash
+```bash
 gpg --list-keys --with-subkey-fingerprints dar-backup@pm.me
-````
+```
+
+</details>
+
+</details>
+
+<br>
 
 ### Breaking change in version 0.6.0
 
@@ -890,17 +1163,22 @@ Version 0.6.0 and forwards requires the config variable *COMMAND_TIMEOUT_SECS* i
 
 This python version is v2 of dar-backup, v1 is made in bash.
 
+## Community
+
+Please review the [Code of Conduct](https://github.com/per2jensen/dar-backup/blob/main/CODE_OF_CONDUCT.md) to help keep this project welcoming and focused.
+
 ## Requirements
 
 - dar
 - par2
 - python3
+- python3-venv
 
 On Ubuntu, install the requirements this way:
 
-```` bash
-    sudo apt install dar par2 python3
-````
+```bash
+    sudo apt install dar par2 python3 python3-venv
+```
 
 ## dar-backup principles
 
@@ -945,58 +1223,72 @@ See more [here](#gpg-signing-key).
 
 ### 1 - installation
 
-Installation is currently in a venv. These commands are installed in the venv:
+Installation is currently in a [virtual environment](https://csguide.cs.princeton.edu/software/virtualenv) (commonly called a `venv`). These commands are installed in the venv:
 
 - dar-back
 - cleanup
 - manager
 - clean-log
+- dar-backup-systemd
 - installer
+- demo
 
 Note:
 
-The module `inputimeout` is installed into the venv and used for the confirmation input (with a 30 second timeout)
+The modules `inputimeout`, `rich`and `argcomplete` are installed into the venv and used by `dar-backup`
 
-To install, create a venv and run pip:
+To install `dar-backup`, create a venv and run pip:
 
-```` bash
+```bash
 mkdir $HOME/tmp
 cd $HOME/tmp
 python3 -m venv venv    # create the virtual environment 
-. venv/bin/activate     # activate the virtual env
+. venv/bin/activate     # activate the virtual environment
 pip install dar-backup  # run pip to install `dar-backup`
-````
+```
 
 I have an alias in ~/.bashrc pointing to my venv:
 
-```` bash
+```bash
 alias db=". ~/tmp/venv/bin/activate; dar-backup -v"
-````
+```
 
-Typing `db` at the command line gives this
+drop the alias into ~/.bashrc like this:
 
-```` bash
+```bash
+grep -qxF 'alias db="' ~/.bashrc \
+  || echo 'alias db=". ~/tmp/venv/bin/activate; dar-backup -v"' >> ~/.bashrc
+
+source ~/.bashrc
+```
+
+Typing `db` at the command line gives something like this:
+
+```bash
 (venv) user@machine:~$ db
 dar-backup 0.6.12
 dar-backup.py source code is here: https://github.com/per2jensen/dar-backup
 Licensed under GNU GENERAL PUBLIC LICENSE v3, see the supplied file "LICENSE" for details.
 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 See section 15 and section 16 in the supplied "LICENSE" file.
-````
+```
 
 ### 2 - configuration
 
-The dar-backup installer is non-destructive and stops if some of the default directories exist.
+The dar-backup [demo](#demo-options) application can be used to demo how `dar-backup` works.
+It creates some directories, installs a demo configuration file and puts a demo backup definition in place.
 
-Run the installer
+`demo` is non-destructive and stops if some of the default directories exist.
 
-```` bash
-installer --install
-````
+Run `demo`
+
+```bash
+demo --install
+```
 
 The output is
 
-```` text
+```text
 Directories created: `/home/user/dar-backup/` and `/home/user/.config/dar-backup`
 Config file deployed to /home/user/.config/dar-backup/dar-backup.conf
 Default backup definition deployed to /home/user/.config/dar-backup/backup.d/default
@@ -1004,7 +1296,7 @@ Default backup definition deployed to /home/user/.config/dar-backup/backup.d/def
 2. Then you can run `dar-backup --full-backup` to create a backup.
 3. List backups with `dar-backup --list`
 4. List contents of a backup with `dar-backup --list-contents <backup-name>`
-````
+```
 
 ### 3 - generate catalog databases
 
@@ -1012,38 +1304,48 @@ Generate the archive catalog database(s).
 
 `dar-backup` expects the catalog databases to be in place, it does not automatically create them (by design)
 
-```` bash
+```bash
 manager --create-db
-````
+```
 
-### 4 - do FULL backups
+### 4 - give dar-backup a spin
 
-Prereq:
-[Backup definitions](#backup-definition-example) are in place in BACKUP.D_DIR (see [config file](#config-file)).
+The `demo` application has put a demo [backup definition](#backup-definition-example) in place in BACKUP.D_DIR (see [config file](#config-file)).
 
-You are ready to do backups of all your backup definitions.
+You are now ready to do backups as configured in the backup definition.
 
-```` bash
-dar-backup --full-backup 
-````
+Give `dar-backup`a spin:
+
+```bash
+dar-backup --full-backup --verbose
+
+# list backups
+dar-backup --list
+
+# see some examples on usage
+dar-backup --examples
+
+# see the log file
+cat "$HOME/dar-backup/dar-backup.log"
+```
 
-If you want to see dar-backup's log entries in the terminal, use the `--log-stdout` option. This can be useful if dar-backup is started by systemd.
+If you want to see dar-backup's log entries in the terminal, use the `--log-stdout` option.
 
 If you want more log messages, use the `--verbose` or `--log-level debug` for even more.
 
-If you want a backup of a single definition, use the `-d <backup definition>` option. The definition's name is the filename of the definition in the `backup.d` config directory.
+If you want to take a backup using a single backup definition, use the `-d <backup definition>` option. The backup definition's name is the filename of the definition in the BACKUP.D_DIR (see [config file](#config-file)).
 
-```` bash
+```bash
 dar-backup --full-backup -d <your backup definition>
-````
+```
 
 ### 5 - deactivate venv
 
-Deactivate the virtual environment (venv)
+Deactivate the virtual environment (venv).
 
-```` bash
+```bash
 deactivate
-````
+```
 
 ## Config
 
@@ -1055,7 +1357,7 @@ If you have your config file somewhere else, use the `--config` option to point
 
 Tilde `~` and environment variables can be used in the paths for various file locations.
 
-```` code
+```text
 [MISC]
 LOGFILE_LOCATION=~/.dar-backup.log
 MAX_SIZE_VERIFICATION_MB = 20
@@ -1070,6 +1372,9 @@ COMMAND_TIMEOUT_SECS = 86400
 BACKUP_DIR = /some/where/dar-backup/backups/
 BACKUP.D_DIR = /some/where/dar-backup/backup.d
 TEST_RESTORE_DIR = /tmp/dar-backup/restore/
+# Optional parameter
+# If you want to store the catalog databases away from the BACKUP_DIR, use the MANAGER_DB_DIR variable.
+#MANAGER_DB_DIR = /some/where/else/
 
 [AGE]
 # age settings are in days
@@ -1088,7 +1393,7 @@ SCRIPT_1 = ls -l /tmp
 [POSTREQ]
 SCRIPT_1 = df -h
 #SCRIPT_2 = another_script.sh
-````
+```
 
 ### .darrc
 
@@ -1098,7 +1403,7 @@ You can override the default `.darrc` using the `--darrc` option.
 
 The default `.darrc` contents are as follows:
 
-```` code
+```text
 #  .darrc configuration file for `dar` as used by the `dar-backup` script.
 #  `dar-backup` lives here: https://github.com/per2jensen/dar-backup
 
@@ -1219,7 +1524,7 @@ compress-exclusion:
 # Now we swap back to case sensitive mode for masks which is the default
 #mode:
 -acase
-````
+```
 
 ### Backup definition example
 
@@ -1228,7 +1533,7 @@ The name of the file is the name of the backup definition.
 
 You can use as many backup definitions as you need.
 
-```` code
+```text
  # Switch to ordered selection mode, which means that the following
  # options will be considered top to bottom
  -am
@@ -1262,7 +1567,7 @@ You can use as many backup definitions as you need.
 # http://dar.linux.free.fr/doc/Features.html
 # https://bford.info/cachedir/
 --cache-directory-tagging
-````
+```
 
 ## Generate systemd files
 
@@ -1272,7 +1577,7 @@ The timers are set as the author uses them, modify to your taste and needs.
 
 Example run:
 
-```` bash
+```bash
 dar-backup-systemd --venv /home/user/tmp/venv --dar-path /home/user/.local/dar/bin
 Generated dar-full-backup.service and dar-full-backup.timer
   → Fires on: *-12-30 10:03:00
@@ -1282,7 +1587,7 @@ Generated dar-incr-backup.service and dar-incr-backup.timer
   → Fires on: *-*-04/3 19:03:00
 Generated dar-clean.service and dar-clean.timer
   → Fires on: *-*-* 21:07:00
-````
+```
 
 ## Systemctl examples
 
@@ -1300,17 +1605,17 @@ systemctl --user daemon-reload
 
 Verify your timers are set up as you want:
 
-```` bash
+```bash
 systemctl --user list-timers
-````
+```
 
 ## Service: dar-backup --incremental-backup
 
-This is an exmaple of a systemd user service unit.
+This is an example of a systemd user service unit.
 
 File:  dar-incr-backup.service
 
-```` bash
+```bash
 /tmp/test$ dar-backup-systemd --venv '$HOME/programmer/dar-backup.py/venv'  --dar-path '$HOME/.local/dar/bin'
 
 Generated dar-full-backup.service and dar-full-backup.timer
@@ -1336,7 +1641,7 @@ RemainAfterExit=no
 
 
 ExecStart=/bin/bash -c 'PATH=$HOME/.local/dar/bin:$PATH && . $HOME/programmer/dar-backup.py/venv/bin/activate && dar-backup -I --verbose --log-stdout'
-````
+```
 
 ## Timer: dar-backup --incremental-backup
 
@@ -1344,7 +1649,7 @@ This is an example of a systemd user timer
 
 File:  dar-incr-backup.timer
 
-```` code
+```text
 [Unit]
 Description=dar-backup INCR timer
 
@@ -1354,7 +1659,7 @@ Persistent=true
 
 [Install]
 WantedBy=timers.target
-````
+```
 
 ## systemd timer note
 
@@ -1362,118 +1667,94 @@ WantedBy=timers.target
 
 ## list contents of an archive
 
-```` bash
-. <the virtual evn>/bin/activate
-dar-backup --list-contents example_FULL_2024-06-23 --selection "-X '*.xmp' -I '*2024-06-16*' -g home/pj/tmp/LUT-play"
+```bash
+# Activate your virtual environment
+source <the virtual evn>/bin/activate
+dar-backup --list-contents media-files_INCR_2025-05-10
+# Deactivate when done
 deactivate
-````
-
-gives
+```
 
-``` code
-[Data ][D][ EA  ][FSA][Compr][S]| Permission | User  | Group | Size    |          Date                 |    filename
---------------------------------+------------+-------+-------+---------+-------------------------------+------------
-[Saved][-]       [-L-][   0%][ ]  drwxr-xr-x   root   root    113 Mio   Sat May 11 16:16:48 2024        home
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 10:46:30 2024        home/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 09:17:42 2024        home/pj/tmp
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj     pj      50 Mio    Wed Jun 19 20:52:13 2024        home/pj/tmp/LUT-play
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj     pj      49 Mio    Sun Jun 16 12:52:22 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF
+gives something like
+
+```text
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user  2 Gio   Sat May 10 14:15:07 2025  home/user
+[Saved][ ]       [-L-][  93%][ ]  -rw-rw-r--   user user  29 kio  Fri May  9 16:45:38 2025  home/user/data/2023/2023-02-11-Udstilling-Fredericia/DSC_0568.NEF.xmp
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user  2 Gio   Fri May  9 12:49:04 2025  home/user/data/2025
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user  193 Mio Thu May  8 15:59:17 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  15 Mio  Thu May  8 15:52:27 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  10 Mio  Thu May  8 15:52:27 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  9 Mio   Thu May  8 15:51:53 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0559.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  16 Mio  Thu May  8 15:51:45 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  12 Mio  Thu May  8 15:51:45 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  16 Mio  Thu May  8 15:51:24 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user  12 Mio  Thu May  8 15:51:23 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG
+[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   user user  22 kio  Thu May  8 15:59:58 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG.xmp
+[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   user user  30 kio  Thu May  8 16:00:36 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF.xmp
+[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   user user  22 kio  Thu May  8 16:00:29 2025  home/user/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG.xmp
 ```
 
 ## dar file selection examples
 
-### select a directory
+> ⚠️ **Quoting matters**
+>
+> Always pass `--selection` as `--selection="-I '*.NEF'"` to ensure it’s treated as a single argument.
+>
+> Avoid splitting `--selection` and the string into separate tokens.
 
-``` bash
-dar -l /tmp/example_FULL_2024-06-23  -g home/pj/tmp/LUT-play
-```
+**Why does --selection give “expected one argument” error?**
 
-gives
+This happens when the shell splits the quoted string or interprets globs before `dar-backup` sees them.  
+✅ Use:   `--selection="-I '*.NEF'"`  
+❌ Avoid: `--selection "-I '*.NEF'"`  
 
-```` code
-[Data ][D][ EA  ][FSA][Compr][S]| Permission | User  | Group | Size    |          Date                 |    filename
---------------------------------+------------+-------+-------+---------+-------------------------------+------------
-[Saved][-]       [-L-][   0%][ ]  drwxr-xr-x   root   root    113 Mio   Sat May 11 16:16:48 2024        home
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 10:46:30 2024        home/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 09:17:42 2024        home/pj/tmp
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj     pj      50 Mio    Wed Jun 19 20:52:13 2024        home/pj/tmp/LUT-play
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj     pj      49 Mio    Sun Jun 16 12:52:22 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      48 kio    Sat Jun 22 21:51:24 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      50 kio    Sat Jun 22 21:51:25 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_01.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:26 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_02.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:27 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_03.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:27 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_04.NEF.xmp
-[Saved][ ]       [-L-][  97%][ ]  -rw-rw-r--   pj     pj      77 kio    Sat Jun 22 21:50:16 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_05.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      52 kio    Sat Jun 22 21:49:37 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_06.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:47 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_07.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:12 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_08.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:12 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_09.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:39 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_10.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:36 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_11.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:35 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_12.NEF.xmp
-[Saved][ ]       [-L-][  88%][ ]  -rw-rw-r--   pj     pj      15 kio    Sat Jun 22 21:51:11 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_13.NEF.xmp
-[Saved][ ]       [-L-][  96%][ ]  -rw-rw-r--   pj     pj      84 kio    Sat Jun 22 21:51:09 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_14.NEF.xmp
-[Saved][ ]       [-L-][  96%][ ]  -rw-rw-r--   pj     pj      90 kio    Sat Jun 22 21:51:04 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_15.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:15 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_16.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:48 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_17.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:19 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_18.NEF.xmp
-````
+> 💡 **Tip:** See [dar's documentation](http://dar.linux.free.fr/doc/man/dar.html#COMMANDS%20AND%20OPTIONS)
+
+### select a directory
 
-### select file dates in the directory
+Select files and sub directories in `home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
 
-``` bash
-dar -l /tmp/example_FULL_2024-06-23  -I '*2024-06-16*' -g home/pj/tmp/LUT-play
+```bash
+dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-g 'home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling'"
 ```
 
 gives
 
-``` code
-[Data ][D][ EA  ][FSA][Compr][S]| Permission | User  | Group | Size    |          Date                 |    filename
---------------------------------+------------+-------+-------+---------+-------------------------------+------------
-[Saved][-]       [-L-][   0%][ ] drwxr-xr-x   root    root    113 Mio   Sat May 11 16:16:48 2024        home
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 10:46:30 2024        home/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 09:17:42 2024        home/pj/tmp
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj     pj      50 Mio    Sed Jun 19 20:52:13 2024        home/pj/tmp/LUT-play
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj     pj      49 Mio    Sun Jun 16 12:52:22 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      48 kio    Sat Jun 22 21:51:24 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      50 kio    Sat Jun 22 21:51:25 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_01.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:26 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_02.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:27 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_03.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      51 kio    Sat Jun 22 21:51:27 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_04.NEF.xmp
-[Saved][ ]       [-L-][  97%][ ]  -rw-rw-r--   pj     pj      77 kio    Sat Jun 22 21:50:16 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_05.NEF.xmp
-[Saved][ ]       [-L-][  95%][ ]  -rw-rw-r--   pj     pj      52 kio    Sat Jun 22 21:49:37 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_06.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:47 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_07.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:12 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_08.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:12 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_09.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:39 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_10.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:36 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_11.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:35 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_12.NEF.xmp
-[Saved][ ]       [-L-][  88%][ ]  -rw-rw-r--   pj     pj      15 kio    Sat Jun 22 21:51:11 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_13.NEF.xmp
-[Saved][ ]       [-L-][  96%][ ]  -rw-rw-r--   pj     pj      84 kio    Sat Jun 22 21:51:09 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_14.NEF.xmp
-[Saved][ ]       [-L-][  96%][ ]  -rw-rw-r--   pj     pj      90 kio    Sat Jun 22 21:51:04 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_15.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:51:15 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_16.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:48 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_17.NEF.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj     pj      24 kio    Sat Jun 22 21:50:19 2024        home/pj/tmp/LUT-play/2024-06-16_12:52:22,15_18.NEF.xmp
+```text
+...
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 10:33:42 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0572.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 28  Mio Fri May  9 10:33:12 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0571.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 25  Mio Fri May  9 10:33:08 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0570.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 27  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0569.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 27  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0568.NEF
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user 833 Mio Fri May  9 12:49:57 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 11  Mio Fri May  9 10:32:45 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0568.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 11  Mio Fri May  9 10:32:46 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0569.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 9   Mio Fri May  9 10:33:08 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0570.JPG
+[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   user user 13  Mio Fri May  9 10:33:12 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0571.JPG
+...
 ```
 
-### exclude .xmp files from that date
-
-``` bash
-dar -l /tmp/example_FULL_2024-06-23 -X '*.xmp' -I '*2024-06-16*' -g home/pj/tmp/LUT-play
+### select files with "Z50" in the file name and exclude .xmp files
 
+```bash
+dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-I '*Z50*' -X '*.xmp'"
 ```
 
-gives
-
-```` code
-[Data ][D][ EA  ][FSA][Compr][S]| Permission | User  | Group | Size    |          Date                 |    filename
---------------------------------+------------+-------+-------+---------+-------------------------------+------------
-[Saved][-]       [-L-][   0%][ ]  drwxr-xr-x   root   root    113 Mio   Sat May 11 16:16:48 2024        home
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 10:46:30 2024        ome/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj     pj      113 Mio   Sun Jun 23 09:17:42 2024        ome/pj/tmp
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj     pj      50 Mio    Wed Jun 19 20:52:13 2024      ` ome/pj/tmp/LUT-play
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj     pj      49 Mio    Sun Jun 16 12:52:22 2024      ` home/pj/tmp/LUT-play/2024-06-16_12:52:22,15.NEF
-````
+gives something like
+
+```text
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Sat May 10 14:15:07 2025 home/user
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Fri May  9 12:49:04 2025 home/user/data/2025
+[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   user user 193 Mio Thu May  8 15:59:17 2025 home/user/data/2025/2025-05-09-Viltrox-25mm-AIR
+[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   user user 2   Gio Fri May  9 16:47:37 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0633.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0632.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 28  Mio Fri May  9 11:09:04 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0631.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0630.NEF
+[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0629.NEF
+...
+```
 
 ## Restoring
 
@@ -1493,7 +1774,7 @@ The directory supplied functions as the Root of the restore operation.
 
 A backup has been taken using this backup definition:
 
-``` code
+```text
 -R /
 -g home/user/Documents
 ```
@@ -1502,34 +1783,41 @@ When restoring and using `/tmp` for --restore-dir, the restored files can be fou
 
 ### a single file
 
-``` code
+```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name> --selection "-g path/to/file"
+dar-backup --restore <archive_name> --selection="-g path/to/file"
 deactivate
-
 ```
 
 ### a directory
 
-``` bash
+```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name> --selection "-g path/to/directory"
+dar-backup --restore <archive_name> --selection="-g path/to/directory"
 deactivate
 ```
 
 ### .NEF from a specific date
 
-``` bash
+The backed up directory contains \*.NEF and \*.xmp files.
+
+Filtering:
+
+- Include files with "2024-06-16" in file name
+- Exclude files with file names ending in ".xmp"
+- Files must be in directory "home/user/tmp/LUT-play", compared to the file root (`-R`option) in the backup.
+
+```bash
 . <the virtual env>/bin/activate
-dar-backup --restore <archive_name>  --selection "-X '*.xmp' -I '*2024-06-16*' -g home/pj/tmp/LUT-play"
+dar-backup --restore <archive_name>  --selection="-I '*2024-06-16*' -X '*.xmp' -g home/user/tmp/LUT-play"
 deactivate
 ```
 
 ### restore test fails with exit code 4
 
-"dar" in newer versions emits a question about file ownership, which is "answered" with a "no" via the "-Q" option. That in turn leads to an error code 4.
+`dar` in newer versions emits a question about file ownership, which is "answered" with a "no" via the "-Q" option. That in turn leads to an error code 4.
 
-Thus the dar option "--comparison-field=ignore-owner" has been placed in the supplied [.darrc](#darrc) file (located in the virtual environment where dar-backup is installed).
+Thus the dar option `--comparison-field=ignore-owner` has been placed in the supplied [.darrc](#darrc) file (located in the virtual environment where dar-backup is installed).
 
 This causes dar to restore without an error.
 
@@ -1542,7 +1830,7 @@ If exit code 5 is emitted on the restore test, FSA (File System specific Attribu
 That (might) occur if you backup a file stored on one type of filesystem, and restore it on another type.
 My home directory is on a btrfs filesystem, while /tmp (for the restore test) is on zfs.
 
-The restore test can result in an exit code 5, due to the different filesystems used. In order to avoid the errors, the "option "--fsa-scope none" can be used. That will restult in FSA's not being restored.
+The restore test can result in an exit code 5, due to the different filesystems used. In order to avoid the errors, the option `--fsa-scope none` can be used. That will restult in FSA's not being restored.
 
 If you need to use this option, un-comment it in the [.darrc](#darrc) file (located in the virtual environment where dar-backup is installed)
 
@@ -1552,28 +1840,28 @@ If you need to use this option, un-comment it in the [.darrc](#darrc) file (loca
 
 You can run a par2 verification on an archive like this:
 
-```` bash
+```bash
 for file in <archive>*.dar.par2; do
   par2 verify "$file"
 done
-````
+```
 
 if there are problems with a slice, try to repair it like this:
 
-```` bash
+```bash
   par2 repair <archive>.<slice number>.dar.par2
-````
+```
 
 ### Par2 create redundancy files
 
 If you have merged archives, you will need to create the .par2 redundency files manually.
 Here is an example
 
-```` bash
+```bash
 for file in <some-archive>_FULL_yyyy-mm-dd.*; do
   par2 c -r5 -n1 "$file"
 done
-````
+```
 
 where "c" is create, -r5 is 5% redundency and -n1 is 1 redundency file
 
@@ -1586,18 +1874,17 @@ One way to do that, is to let dar create a FULL archive from scratch, another is
 
 I do backups of my homedir. Here it is shown how a FULL archive is merged with a DIFF, creating a new FULL archive.
 
-```` bash
-dar --merge pj-homedir_FULL_2021-09-12  -A pj-homedir_FULL_2021-06-06  -@pj-homedir_DIFF_2021-08-29 -s 12G
+```bash
+dar --merge user-homedir_FULL_2021-09-12  -A user-homedir_FULL_2021-06-06  -@user-homedir_DIFF_2021-08-29 -s 12G
 
 # test the new FULL archive
-dar -t pj-homedir_FULL_2021-09-12
+dar -t user-homedir_FULL_2021-09-12
 
 # create Par2 redundancy files
-for file in pj-homedir_FULL_yyyy-mm-dd.*.dar; do
+for file in user-homedir_FULL_yyyy-mm-dd.*.dar; do
   par2 c -r5 -n1 "$file"
 done
-
-````
+```
 
 ### dar manager databases
 
@@ -1645,8 +1932,144 @@ dar-backup displays 2 visual artifacts to show progress.
 
 The indicators are not shown if dar-backup is run from systemd or if it is used in terminal multiplexers like `tmux` or `screen`. So no polluting of journald logs.
 
+### Shell autocompletion
+
+The `dar-backup`, `manager`, and `cleanup` scripts now support dynamic Bash tab-completion, making them easier and faster to use.
+
+✅ Features
+
+- Autocomplete for all long options (--config-file, --restore, etc.)
+
+- Dynamic suggestions based on your config:
+
+- --backup-definition shows available definitions from backup.d/
+
+- show relevant archives when a backup definition has been chosen:
+
+  dar-backup: --restore, --list-contents, and --alternate-reference-archive
+
+  cleanup: --cleanup-specific-archives
+
+  manager:  --list-archive-contents, --add-specific-archive (autocomplete those **not* in the catalog database), --remove-specific-archive
+  
+- Supports paths like ~ and $HOME correctly
+
+#### Use it
+
+Try typing:
+
+```bash
+dar-backup --<TAB>
+```
+
+You should see all available flags like --full-backup, --restore, etc.
+
+Try completion of backup definition and then list contents:
+
+```bash
+    dar-backup --backup-definition <TAB>
+    dar-backup -d <the chosen backup-definition> --list-contents <TAB>
+```
+
+#### Archive name completion (smart, context-aware)
+
+When using `manager--list-archive-contents`, the tab-completer suggests valid archive names.
+
+The behavior is smart and context-aware:
+
+- If a --backup-definition (-d) is provided, archive suggestions are restricted to that .db catalog.
+
+- If no backup definition is given, the completer will:
+
+  - Scan all .db files in the backup_dir
+
+  - Aggregate archive names across all catalogs
+
+  - Sort results by:
+
+    - Backup name (e.g. pCloudDrive, media-files)
+
+    - Date inside the archive name (e.g. 2025-04-19)
+
+It’s blazing fast and designed for large backup sets.
+
+```bash
+# With a backup definition
+manager -d pCloudDrive --list-archive-contents <TAB>
+# ⤷ Suggests: pCloudDrive_FULL_2025-03-04, pCloudDrive_INCR_2025-04-19, ...
+
+# Without a backup definition
+manager --list-archive-contents <TAB>
+# ⤷ Suggests: all archives across all known backup definitions
+# ⤷ Example: media-files_FULL_2025-01-04, pCloudDrive_INCR_2025-04-19, ...
+
+# Filter by prefix
+manager --list-archive-contents media-<TAB>
+# ⤷ Suggests: media-files_FULL_2025-01-04, media-files_INCR_2025-02-20, ...
+```
+
+#### Enabling Bash completion
+
+Try auto completion in your session:
+
+```bash
+eval "$(register-python-argcomplete dar-backup)"
+eval "$(register-python-argcomplete cleanup)"
+eval "$(register-python-argcomplete manager)"
+#complete -o nosort -C 'python -m argcomplete cleanup' cleanup
+#complete -o nosort -C 'python -m argcomplete manager' manager
+```
+
+To make it persistent across sessions, add this to your ~/.bashrc:
+
+```bash
+# Enable autocompletion for dar-backup
+eval "$(register-python-argcomplete dar-backup)"
+eval "$(register-python-argcomplete cleanup)"
+eval "$(register-python-argcomplete manager)"
+# This disables bash sorting, so sorting is by <backup definition> and <date>
+#complete -o nosort -C 'python -m argcomplete cleanup' cleanup
+#complete -o nosort -C 'python -m argcomplete manager' manager
+```
+
+If you're using a virtual environment and register-python-argcomplete isn't in your global PATH, use:
+
+```bash
+# Enable autocompletion for dar-backup
+eval "$($(which register-python-argcomplete) dar-backup)"
+eval "$($(which register-python-argcomplete) cleanup)"
+eval "$($(which register-python-argcomplete) manager)"
+
+# If it's not working, try reactivating your virtualenv and restarting your terminal.
+```
+
+Then reload your shell:
+
+```bash
+source ~/.bashrc
+```
+
+#### Enable Zsh Completion
+
+If you're using Zsh, add this to your .zshrc:
+
+```zsh
+autoload -U bashcompinit
+bashcompinit
+eval "$(register-python-argcomplete dar-backup)"
+eval "$(register-python-argcomplete cleanup)"
+eval "$(register-python-argcomplete manager)"
+```
+
+Then reload Zsh:
+
+```zsh
+source ~/.zshrc
+```
+
 ## Todo
 
+- When run interactively, a progress bar during test and par2 generation would be nice.
 - Look into a way to move the .par2 files away from the `dar` slices, to maximize chance of good redundancy.
 - Add option to dar-backup to use the `dar` option `--fsa-scope none`
 
@@ -1658,54 +2081,65 @@ One backup definition per file
 
 .par2 files created for each slice (may be moved in future)
 
+## Projects these scripts benefit from
+
+ 1. [The wonderful dar achiver](https://github.com/Edrusb/DAR)
+ 2. [The Parchive suite](https://github.com/Parchive)
+ 3. [shellcheck - a bash linter](https://github.com/koalaman/shellcheck)
+ 4. [Ubuntu of course :-)](https://ubuntu.com/)
+ 5. [PyPI](https://pypi.org/)
+ 6. Tracking PyPI downloads with [pypi-total-downloads-tracker](https://github.com/per2jensen/pypi-total-downloads-tracker)
+
 ## Reference
 
 ### CLI Tools Overview
 
-| Command               | Description                               |
-|-----------------------|-------------------------------------------|
-| `dar-backup`          | Perform full, differential, or incremental backups with verification and restore testing |
-| `manager`             | Maintain and query catalog databases for archives |
-| `cleanup`             | Remove outdated DIFF/INCR archives (and optionally FULLs) |
-| `clean-log`           | Clean up excessive log output from dar command logs |
-| `installer`           | Set up required directories and default config files |
-| `dar-backup-systemd`  | Generate (and optionally install) systemd timers and services for automated backups |
+| Command              | Description                               |
+|----------------------|-------------------------------------------|
+| [dar-backup](#dar-backup-options)| Perform full, differential, or incremental backups with verification and restore testing |
+| [manager](#manager-options)      | Maintain and query catalog databases for archives |
+| [cleanup](#cleanup-options)      | Remove outdated DIFF/INCR archives (and optionally FULLs) |
+| [clean-log](#clean-log-options)  | Clean up excessive log output from dar command logs |
+| [dar-backup-systemd](#dar-backup-systemd-options) | Generate (and optionally install) systemd timers and services for automated backups |
+| [installer](#installer-options)  | Set up directories and optionally create catalog databases according to a config file |
+| [demo](#demo-options)            | Set up required directories and config files for a demo|
 
 ### test coverage
 
 Running
 
-```` bash
+```bash
 pytest --cov=dar_backup tests/
-````
+```
 
-results for a dev version 0.6.19 in this report:
+Results for a version 0.6.19 in this report:
 
-```` code
----------- coverage: platform linux, python 3.12.3-final-0 -----------
+```text
 Name                                   Stmts   Miss  Cover
 ----------------------------------------------------------
 src/dar_backup/__about__.py                1      0   100%
 src/dar_backup/__init__.py                 0      0   100%
 src/dar_backup/clean_log.py               68     13    81%
-src/dar_backup/cleanup.py                193     17    91%
-src/dar_backup/command_runner.py          73      1    99%
-src/dar_backup/config_settings.py         66      8    88%
-src/dar_backup/dar_backup.py             535     56    90%
+src/dar_backup/cleanup.py                196     17    91%
+src/dar_backup/command_runner.py          80      3    96%
+src/dar_backup/config_settings.py         66      7    89%
+src/dar_backup/dar_backup.py             539     56    90%
 src/dar_backup/dar_backup_systemd.py      56      7    88%
 src/dar_backup/installer.py               59      6    90%
-src/dar_backup/manager.py                351     56    84%
+src/dar_backup/manager.py                403     54    87%
 src/dar_backup/rich_progress.py           70      7    90%
-src/dar_backup/util.py                   130     15    88%
+src/dar_backup/util.py                   231     24    90%
 ----------------------------------------------------------
-TOTAL                                   1602    186    88%
-````
+TOTAL                                   1769    194    89%
+```
+
+### Dar-backup options
 
-### dar-backup options
+This script does backups including par2 redundancy, validation and restoring.
 
-This script does backups, validation and restoring. It has the following options:
+Available options:
 
-``` code
+```bash
 -F, --full-backup                    Perform a full backup.
 -D, --differential-backup            Perform a differential backup.
 -I, --incremental-backup             Perform an incremental backup.
@@ -1724,34 +2158,39 @@ This script does backups, validation and restoring. It has the following options
 --log-level <level>                  `debug` or `trace`, default is `info`.
 --log-stdout                         Also print log messages to stdout.
 --do-not-compare                     Do not compare restores to file system.
--v --version                         Show version and license information.
+-v, --version                         Show version and license information.
 ```
 
-### manager options
+### Manager Options
 
-This script manages `dar` databases and catalogs. Available options:
+This script manages `dar` databases and catalogs.
 
-``` code
--c, --config-file                    Path to dar-backup.conf
+Available options:
+
+```bash
+-c, --config-file <path>             Path to dar-backup.conf.
 --create-db                          Create missing databases for all backup definitions.
 --alternate-archive-dir <path>       Use this directory instead of BACKUP_DIR in the config file.
 --add-dir <path>                     Add all archive catalogs in this directory to databases.
--d, --backup-def <name>              Restrict to work only on this backup definition.
---add-specific-archive <archive>     Add this archive to the catalog database.
---remove-specific-archive <archive>  Remove this archive from the catalog database.
+-d, --backup-def <name>              Restrict operations to this backup definition.
+--add-specific-archive <archive>     Add a specific archive to the catalog database.
+--remove-specific-archive <archive>  Remove a specific archive from the catalog database.
 -l, --list-catalogs                  List catalogs in databases for all backup definitions.
---list-catalog-contents <num>        List contents of a catalog by catalog number.
---list-archive-contents <archive>    List contents of an archive’s catalog, given the archive name.
+--list-archive-contents <archive>    List the contents of an archive’s catalog by archive name.
 --find-file <file>                   Search catalogs for a specific file.
 --verbose                            Enable verbose output.
---log-level <level>                  `debug` or `trace`, default is `info`", default="info".
+--log-level <level>                  Set log level (`debug` or `trace`, default is `info`).
 ```
 
-### cleanup options
+### Cleanup options
+
+This script removes old backups and par2 files according to `[AGE]` settings in config file.
 
-This script cleans up old backups and par2 files. Supported options:
+Catalogs in catalog databases are also removed.
 
-``` code
+Supported options:
+
+```bash
 -d, --backup-definition                           Backup definition to cleanup.
 -c, --config-file                                 Path to 'dar-backup.conf'
 -v, --version                                     Show version & license information.
@@ -1764,11 +2203,11 @@ This script cleans up old backups and par2 files. Supported options:
 --test-mode                                       This is used when running pytest test cases
 ```
 
-### clean-log options
+### Clean-log options
 
 This script removes excessive logging output from `dar` logs, improving readability and efficiency. Available options:
 
-``` code
+```bash
 -f, --file <path>          Specify the log file(s) to be cleaned.
 -c, --config-file <path>   Path to dar-backup.conf.
 --dry-run                  Show which lines would be removed without modifying the file.
@@ -1776,9 +2215,35 @@ This script removes excessive logging output from `dar` logs, improving readabil
 -h, --help                 Displays usage info
 ```
 
-### installer options
+### Dar-backup-systemd options
+
+Generates and optionally install systemd user service units and timers.
+
+```bash
+-h, --help           Show this help message and exit
+--venv VENV          Path to the Python venv with dar-backup
+--dar-path DAR_PATH  Optional path to dar binary's directory
+--install            Install the units to ~/.config/systemd/user
+```
+
+### Installer options
 
-Sets up `dar-backup`for a user.
+Sets up `dar-backup` according to provided config file.
+
+The installer creates the necessary backup catalog databases if `--create-db` is given.
+
+```bash
+--config                 Sets up `dar-backup`.
+--create-db              Create backup catalog databases. Add it to --config
+--install-autocompletion Add bash or zsh auto completion - idempotent
+--remove-autocompletion  Remove the auto completion from bash or zsh
+-v, --version            Display version and licensing information.
+-h, --help               Displays usage info
+```
+
+### Demo options
+
+Sets up `dar-backup` in a demo configuration.
 
 It is non-destructive and stops if directories are already in place.
 
@@ -1795,19 +2260,15 @@ Sets up demo config files:
 - ~/.config/dar-backup/dar-backup.conf
 - ~/.config/dar-backup/backup.d/default
 
-``` code
--i, --install              Sets up `dar-backup`.
--v, --version              Display version and licensing information.
--h, --help                 Displays usage info
-```
-
-### dar-backup-systemd
-
-Generates and optionally install systemd user service units and timers
-
-``` code
--h, --help           Show this help message and exit
---venv VENV          Path to the Python venv with dar-backup
---dar-path DAR_PATH  Optional path to dar binary's directory
---install            Install the units to ~/.config/systemd/user
+```bash
+-i, --install       Sets up `dar-backup`.
+--root-dir          Specify the root directory for the backup.
+--dir-to-backup     Directory to backup, relative to the root directory.
+--backup-dir        Directory where backups and redundancy files are put.
+--override          By default, the script will not overwrite existing files or directories.
+                    Use this option to override this behavior.
+--generate          Generate config files and put them in /tmp/ for inspection
+                    without writing to $HOME.
+-v, --version       Display version and licensing information.
+-h, --help          Displays usage info
 ```