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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 0.6.21
+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,6 +691,7 @@ 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
 
@@ -702,24 +703,27 @@ Description-Content-Type: text/markdown
 [![codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/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 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/)
+[![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 [parchive](https://github.com/Parchive/par2cmdline) 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**](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
 
 - [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)
@@ -731,7 +735,7 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [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)
@@ -775,21 +779,22 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [manager](#manager-options)
   - [cleanup](#cleanup-options)
   - [clean-log](#clean-log-options)
-  - [dar-backup-systemd](#dar-backup-systemd)
-  - [Installer](#installer)
-  - [demo](#demo)
+  - [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 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)
@@ -797,11 +802,252 @@ I have cloud storage mounted on a directory within my home dir. The filesystem i
 
  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  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
 
 As of August 8, 2024 I am using the alpha versions of `dar-backup` (alpha-0.5.9 onwards) in my automated backup routine.
@@ -977,7 +1223,7 @@ 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
@@ -989,15 +1235,15 @@ Installation is currently in a venv. These commands are installed in the venv:
 
 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
 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`
 ```
 
@@ -1010,7 +1256,7 @@ alias db=". ~/tmp/venv/bin/activate; dar-backup -v"
 drop the alias into ~/.bashrc like this:
 
 ```bash
-grep -qxF 'alias db=". ~/tmp/venv/bin/activate; dar-backup -v"' ~/.bashrc \
+grep -qxF 'alias db="' ~/.bashrc \
   || echo 'alias db=". ~/tmp/venv/bin/activate; dar-backup -v"' >> ~/.bashrc
 
 source ~/.bashrc
@@ -1029,7 +1275,10 @@ See section 15 and section 16 in the supplied "LICENSE" file.
 
 ### 2 - configuration
 
-The dar-backup `demo` 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.
+
+`demo` is non-destructive and stops if some of the default directories exist.
 
 Run `demo`
 
@@ -1059,22 +1308,32 @@ Generate the archive catalog database(s).
 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.
+
+Give `dar-backup`a spin:
 
 ```bash
-dar-backup --full-backup 
+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
 dar-backup --full-backup -d <your backup definition>
@@ -1082,7 +1341,7 @@ dar-backup --full-backup -d <your backup definition>
 
 ### 5 - deactivate venv
 
-Deactivate the virtual environment (venv)
+Deactivate the virtual environment (venv).
 
 ```bash
 deactivate
@@ -1419,20 +1678,20 @@ deactivate
 gives something like
 
 ```text
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj  2 Gio   Sat May 10 14:15:07 2025  home/pj
-[Saved][ ]       [-L-][  93%][ ]  -rw-rw-r--   pj pj  29 kio  Fri May  9 16:45:38 2025  home/pj/data/2023/2023-02-11-Udstilling-Fredericia/DSC_0568.NEF.xmp
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj  2 Gio   Fri May  9 12:49:04 2025  home/pj/data/2025
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj  193 Mio Thu May  8 15:59:17 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  15 Mio  Thu May  8 15:52:27 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  10 Mio  Thu May  8 15:52:27 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0563.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  9 Mio   Thu May  8 15:51:53 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0559.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  16 Mio  Thu May  8 15:51:45 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  12 Mio  Thu May  8 15:51:45 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  16 Mio  Thu May  8 15:51:24 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj  12 Mio  Thu May  8 15:51:23 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG
-[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   pj pj  22 kio  Thu May  8 15:59:58 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.JPG.xmp
-[Saved][ ]       [-L-][  92%][ ]  -rw-rw-r--   pj pj  30 kio  Thu May  8 16:00:36 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0557.NEF.xmp
-[Saved][ ]       [-L-][  91%][ ]  -rw-rw-r--   pj pj  22 kio  Thu May  8 16:00:29 2025  home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR/DSC_0558.JPG.xmp
+[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
@@ -1453,26 +1712,26 @@ This happens when the shell splits the quoted string or interprets globs before
 
 ### select a directory
 
-Select files and sub directories in `home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
+Select files and sub directories in `home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
 
 ```bash
-dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-g 'home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling'"
+dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-g 'home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling'"
 ```
 
 gives
 
 ```text
 ...
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 10:33:42 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0572.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 28  Mio Fri May  9 10:33:12 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0571.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 25  Mio Fri May  9 10:33:08 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0570.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 27  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0569.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 27  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0568.NEF
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj 833 Mio Fri May  9 12:49:57 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 11  Mio Fri May  9 10:32:45 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0568.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 11  Mio Fri May  9 10:32:46 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0569.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 9   Mio Fri May  9 10:33:08 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0570.JPG
-[Saved][ ]       [-L-][   1%][X]  -rw-rw-r--   pj pj 13  Mio Fri May  9 10:33:12 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/jpeg/Z50_0571.JPG
+[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
 ...
 ```
 
@@ -1485,15 +1744,15 @@ dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-I '*Z50*' -
 gives something like
 
 ```text
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Sat May 10 14:15:07 2025 home/pj
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Fri May  9 12:49:04 2025 home/pj/data/2025
-[Saved][-]       [-L-][   1%][ ]  drwxrwxr-x   pj pj 193 Mio Thu May  8 15:59:17 2025 home/pj/data/2025/2025-05-09-Viltrox-25mm-AIR
-[Saved][-]       [-L-][   0%][ ]  drwxrwxr-x   pj pj 2   Gio Fri May  9 16:47:37 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 26  Mio Fri May  9 11:26:16 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0633.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 26  Mio Fri May  9 11:26:16 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0632.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 28  Mio Fri May  9 11:09:04 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0631.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 11:09:03 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0630.NEF
-[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   pj pj 29  Mio Fri May  9 11:09:03 2025 home/pj/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0629.NEF
+[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
 ...
 ```
 
@@ -1524,9 +1783,9 @@ When restoring and using `/tmp` for --restore-dir, the restored files can be fou
 
 ### a single file
 
-```text
+```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
 ```
 
@@ -1534,15 +1793,23 @@ deactivate
 
 ```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
 
+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
 ```
 
@@ -1608,13 +1875,13 @@ 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
+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
 ```
@@ -1749,8 +2016,8 @@ Try auto completion in your session:
 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
+#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:
@@ -1761,8 +2028,8 @@ 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
+#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:
@@ -1835,7 +2102,7 @@ One backup definition per file
 | [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 default config files |
+| [demo](#demo-options)            | Set up required directories and config files for a demo|
 
 ### test coverage
 
@@ -1966,10 +2233,12 @@ 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.
--v, --version        Display version and licensing information.
--h, --help           Displays usage info
+--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
@@ -1992,7 +2261,14 @@ Sets up demo config files:
 - ~/.config/dar-backup/backup.d/default
 
 ```bash
--i, --install              Sets up `dar-backup`.
--v, --version              Display version and licensing information.
--h, --help                 Displays usage info
+-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
 ```