<div align='center'>

nvrs

🚦 fast new version checker for software releases 🦀

<br> <br>

</div>

Features

nvchecker compatibility

check the release notes and configuration docs for compatibility updates and instructions.

Speed

<img align='right' src='https://media1.tenor.com/m/mMWXOkCEndoAAAAC/ka-chow-lightning-mcqueen.gif' alt='ka-chow' width=80 height=45>

| command | time per updated package | details | |---------------|------------------------------|--------------------------------------------------------| | nvrs | ~ 0.03s | API requests included<br>depends on internet speed | | nvrs --cmp | ~ 0.0008s | depends on disk speed | | nvrs --take | ~ 0.001s | depends on disk speed |

Sources

• aur
• cratesio
• gitea
• github
• gitlab (with custom hosts)
• website (regex)
• shell

QOL improvements

• ALL argument for the --take command
• --no-fail flag to prevent exiting on recoverable errors
• --nuke command to delete packages from all files
• --list-sources command to list all available sources

Installation

<a href="https://repology.org/project/nvrs/versions"><img align="right" src="https://repology.org/badge/vertical-allrepos/nvrs.svg" alt="Packaging status"></a>

see the installation guide for instructions on how to install nvrs.

Usage

nvrs relies on a configuration file. see configuration.

<img align='center' src='https://vhs.charm.sh/vhs-7j0ZLSJUnq5W8xwqjK14W4.gif' alt='Packaging status'>

the core commands are:

• nvrs - fetches latest versions of defined packages
• nvrs --cmp - compares newver with oldver and displays differences
• nvrs --take - automatically updates oldver. takes in a comma-separated list of package names (ALL for all packages)
• nvrs --nuke - deletes packages from all files. takes in a comma-separated list of names (yes, just like a hitman)
• the --no-fail flag - as the name suggests, specifying this will make nvrs not exit on recoverable errors

Example usage

# download the example configuration file
curl -L 'https://github.com/adamperkowski/nvrs/raw/main/nvrs.toml' -o nvrs.toml

# fetch latest package versions (should return `NONE -> version` for all packages)
nvrs --no-fail

# compare them to latest known versions (should also return `NONE -> version`)
nvrs -c

# update the known versions
nvrs -t ALL

for all available commands, options and flags, see nvrs --help and the manual page.

Documentation

full documentation can be found at nvrs.adamperkowski.dev. nvrs library documentation can be found at docs.rs/nvrs

Contributing

if you want to contribute to the project, please read the Contributing Guidelines before doing so.

if you find any parts of the code or the documentation unclear, or have any suggestions, feel free to open an issue or a pull request.

Credits

• 依云 | the original nvchecker
• orhun | the idea

<div align='center'>

<sub align='center'>Copyright (c) 2025 Adam Perkowski<br>see LICENSE</sub>

</div>