pr-ez/prez-pkglog

Description

Cross-platform logger that records every package install/remove and files downloaded to ~/Downloads — supports DNF, APT, Pacman, Homebrew, Chocolatey, Winget…

Installation Instructions

Installation

Package builds will soon be available from my Copr repository. Until then, build the RPM locally (see below) or install with pipx:

# temporary installation via pipx
pipx install prez-pkglog==0.5.0

---

Configuration

User Scope (Default)

User scope logs packages for the current user only. Files are stored in ~/.local/share/prez-pkglog/.

Configuration file: ~/.config/prez-pkglog/prez_pkglog.conf

[main]
scope = user
enable_dnf_hooks = true
enable_download_monitoring = true
downloads_dir = ~/Downloads
monitored_extensions = .rpm, .deb, .pkg.tar.zst, .tar.gz, .zip, .AppImage
log_format = both

System Scope (Requires Administrator)

System scope logs packages system-wide. Files are stored in /var/log/prez-pkglog/.

Configuration file: /etc/prez-pkglog/prez_pkglog.conf

[main]
scope = system
enable_dnf_hooks = true
enable_download_monitoring = false
# downloads_dir and monitored_extensions are ignored in system scope
log_format = both

DNF Plugin Configuration

User scope: ~/.config/dnf/plugins/prez_pkglog.conf

[main]
enabled = 1
scope = user

System scope: /etc/dnf/plugins/prez_pkglog.conf

[main]
enabled = 1
scope = system

---

Usage

All commands can be run with --scope user (default) or --scope system (requires sudo).

Setup

Initializes configuration and directories.

prez-pkglog setup

Check Status

Show current status and statistics.

prez-pkglog status

Start Monitoring

Starts the monitoring daemon. For users, this monitors the downloads directory.

# Start download monitoring (user scope only)
prez-pkglog daemon

# To run as a service:
systemctl --user enable --now prez-pkglog.service

Query Logs

Search the package logs.

# Find all packages with 'nginx' in the name
prez-pkglog query --name nginx

# Find packages installed with dnf in the last 30 days
prez-pkglog query --manager dnf --days 30

Export Logs

Export the full log to stdout.

# Export user logs as JSON
prez-pkglog export --format json

Manual Logging

Manually log a package installation or removal.

# Log a package installation
prez-pkglog install package-name dnf

# Log a package removal
prez-pkglog remove package-name dnf

# Log a downloaded file
prez-pkglog install downloaded-file.zip download

---

Shell Integration

Shell wrapper to log every git clone

.zshrc

function pkglog_preexec() {
    [[ $1 == git\ clone* ]] || return
    local repo=${${1#git clone }##*/}
    repo=${repo%.git}
    prez-pkglog install $repo git
}
autoload -Uz add-zsh-hook
add-zsh-hook preexec pkglog_preexec

.bashrc

function _pkglog_bash_preexec() {
   [[ $BASH_COMMAND == git\ clone* ]]  || return
   local repo=${BASH_COMMAND#git clone}
   repo=${repo##*/}
   repo=${repo%.git}
   prez-pkglog install "$repo" git
}

config.fish

function fish_preexec --on-event fish_preexec
  if string match -rq '^git clone ' -- $argv[1]
    set repo (basename (string replace -r '^git clone +' '' $argv[1]) .git)
    prez-pkglog install $repo git
  end
end

---

Log File Examples

JSON Format

[
  {
    "name": "neovim",
    "manager": "dnf",
    "action": "install",
    "date": "2025-06-21T17:02:41-05:00",
    "removed": false,
    "scope": "user",
    "version": "0.9.5-1.fc42",
    "metadata": {
      "arch": "x86_64",
      "repo": "fedora"
    }
  },
  {
    "name": "firefox-120.0.tar.bz2",
    "manager": "download",
    "action": "install",
    "date": "2025-06-21T18:30:15-05:00",
    "removed": false,
    "scope": "user",
    "metadata": {
      "file_path": "/home/user/Downloads/firefox-120.0.tar.bz2",
      "file_size": 52428800,
      "file_type": ".tar.bz2"
    }
  }
]

TOML Format

[[package]]
name = "neovim"
manager = "dnf"
action = "install"
date = "2025-06-21T17:02:41-05:00"
removed = false
scope = "user"
version = "0.9.5-1.fc42"

[package.metadata]
arch = "x86_64"
repo = "fedora"

[[package]]
name = "firefox-120.0.tar.bz2"
manager = "download"
action = "install"
date = "2025-06-21T18:30:15-05:00"
removed = false
scope = "user"

[package.metadata]
file_path = "/home/user/Downloads/firefox-120.0.tar.bz2"
file_size = 52428800
file_type = ".tar.bz2"

---

File Locations

User Scope

• Log files: ~/.local/share/prez-pkglog/
  • packages.json
  • packages.toml
• Configuration: ~/.config/prez-pkglog/prez_pkglog.conf
• DNF plugin config: ~/.config/dnf/plugins/prez_pkglog.conf

System Scope

• Log files: /var/log/prez-pkglog/
  • packages.json
  • packages.toml
• Configuration: /etc/prez-pkglog/prez_pkglog.conf
• DNF plugin config: /etc/dnf/plugins/prez_pkglog.conf

---

Building the RPM yourself

With the provided Makefile, building and installing a local version of the RPM is simple.

# Create the SRPM and RPM packages
make rpm

# Install the newly built package
make install

The Makefile handles placing the source tarball in the correct rpmbuild directory for you.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
EPEL 9	x86_64 (0)*	EPEL 9 (2 downloads)
Fedora 42	aarch64 (0)*, x86_64 (0)*	Fedora 42 (7 downloads)
Fedora rawhide	aarch64 (0)*, x86_64 (0)*	Fedora rawhide (3 downloads)

* Total number of downloaded packages.