nvchecker(1) General Commands Manual nvchecker(1) (NAME) nvchecker - nvchecker ( new version checker) . 2.0 . 1.x v1.x . (DEPENDENCIES) o Python 3.9+ o : structlog platformdirs tomli ( < 3.11) o ( ): o tornado + pycurl o aiohttp o httpx http2 ( ) o tornado o (INSTALL AND RUN) : pip3 install nvchecker : python3 setup.py install : nvchecker --help : nvchecker -c config_file.toml : [nvchecker] source = "github" github = "lilydjwg/nvchecker" [python-toml] source = "pypi" pypi = "toml" "version record files" ..SS JSON (JSON logging) --logger=json --logger=both . --json-log-fd=FD (file descriptor) ( ). (-l --logging) . JSON JSON . . event=updated . name revision old_version version . old_version null revision . event=up-to-date . name version . event=no-result . . name . level=error . name exc_info . 1.x (Upgrade from 1.x version) 1.x . 1. 2.x Python 3.7 . 2. . -c ( ). 3. ini toml . nvchecker-ini2toml . () . 4. : max_concurrent max_concurrency - _ . 5. source . . 6. JSON ( ). 7. vcs . ( lilac .) git . 8. include_tags_pattern ignored_tags . List Options . (VERSION RECORD FILES) . JSON . nvtake . . . ( ) . nvchecker . . . nvcmp newver oldver : $ nvcmp -c sample_source.toml Sparkle Test App None -> 2.0 test 0.0 -> 0.1 (CONFIGURATION FILES) toml . (key name) . nvchecker . sample_source.toml . (Configuration Table) __config__ . ~ . : oldver . newver . proxy HTTP . proto://host:port http://localhost:8087. pycurl socks5h://host:port . max_concurrency . : 20. http_timeout HTTP. : 20. keyfile toml (). keys . () . keyfile.toml: [keys] # https://github.com/settings/tokens # scope: repo -> public_repo github = "ghp_" . . prefix . . prefix from_pattern/to_pattern prefix . from_pattern, to_pattern Python . from_pattern to_pattern . from_pattern . missing_ok . . proxy HTTP . proto://host:port http://localhost:8087. pycurl socks5h://host:port . "" ( ) . HTTP aur ( ). user_agent user agent HTTP. tries . 1 . HTTP . httptoken Authorization . . o Bearer : Bearer o Basic : Basic keyfile httptoken_{name} . verify_cert HTTPS. true . (List Options) . . include_regex . regex . .* ! exclude_regex . regex . .* ! include_regex include_regex . sort_version_key . parse_version vercmp awesomeversion portage . parse_version . parse_version pkg_resources.parse_version . vercmp pyalpm.vercmp . awesomeversion awesomeversion . portage portage.versions.vercmp . ignored . "" . source = "regex" . : url URL . encoding () latin1 . regex . (capture group) . . . post_data () GET POST . . post_data_type . post_data_type () Content-Type (post_data) . application/x-www-form-urlencoded . List Options . HTTP source = "httpheader" HTTP . url URL HTTP. header () . Location . Content-Disposition . regex . . . . method () HTTP . HEAD . follow_redirects () 3xx HTTP . false . Location . HTML source = "htmlparser" HTTP xpath . url URL HTTP. xpath xpath . is_xml XML HTML true . post_data () GET POST . . post_data_type . post_data_type () Content-Type (post_data) . application/x-www-form-urlencoded . RSS : [ProxmoxVE] source = "htmlparser" url = "https://my.proxmox.com/en/announcements/tag/proxmox-ve/rss" xpath = "//item/title" is_xml = true from_pattern = 'Proxmox VE ([\d.]+) released!' to_pattern = '\1' : "lxml" . pip install 'nvchecker[htmlparser]' . source = "jq" HTTP jq . url (URL) HTTP. filter jq . post_data () POST ( GET) . . post_data_type . post_data_type () Content-Type (post_data) . application/json . (List Options) . : "jq" . source = "cmd" . (strip) . cmd . ( /bin/sh) . AUR source = "aur" . . aur AUR. (table name) . strip_release (release). use_last_modified . GitHub source = "github" GitHub . %Y%m%d.%H%M%S 20130701.012212 use_latest_release use_max_tag use_max_release . . github github lilydjwg/nvchecker. branch : . path . host (hostname) GitHub. use_latest_release (release) GitHub true . GitHub . zfsonlinux/zfs nvchecker use_max_tag . . ( . .) use_max_release GitHub true . sort_version_key . . use_release_name use_latest_release use_max_release true true nvchecker . include_prereleases use_latest_release use_max_release true true . ( ) . v4 GraphQL API . use_latest_tag GitHub true . v4 GraphQL API . query use_latest_tag true . GitHub . use_max_tag GitHub true . use_max_release (annotated) (lightweight) sort_version_key . . token API . use_latest_tag include_prereleases . : o token o keyfile ( github.com) o netrc use_max_tag use_max_release (List Options) ..SS " RichResult (RichResult metadata)" GitHub API RichResult . API (timestamp) . +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ | (Mode) | creation_time | revision_creation_time | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |/ | 0.0 o 2 168u | | | | | | | | | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_latest_release | | 0.0 o 2 168u | | | | | | | | | | | (release) | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_max_release | | 0.0 o 2 168u | | | | | | | | | | | (release) | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_latest_release + | | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |include_prereleases | | | | | | | | | | | | | (release) | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_latest_tag | 0.0 o 2 168u | | | | | | | | | | | | | (annotated tags) | | | | | | | | | | | | | | | | (lightweight tags) | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_max_tag | 0.0 o 2 168u | 0.0 o 2 168u | | Gitea | | | |0.0 | | | |3.5 | | | | | | | |source = "gitea" | | | | | | | | | | | |168u | | | | | | | |168u | | | |Gitea . %Y%m%d 20130701 use_max_tag . . | | | |0.0 | | | | | | | |gitea | | | | gitea / gitea/tea. | | | | | | | |branch | | | | : . | | | | | | | |use_max_tag | | | | true Gitea . pkg_resources.parse_version . . | | | | | | | |use_latest_release | | | | true gitea . | | | | Gitea git . ciberandy/qiv . | | | | | | | |host | | | | (hostname) (self-hosted) Gitea. | | | | | | | |token | | | | Gitea API . | | | | | | | |168u | | | | : | | | |0.0 | | | |o 2 | | | | token | | | |o 2 | | | | keyfile ( gitea.com) | | | |o 2 | | | | netrc | | | | | | | |168u | | | | use_max_tag List Options . | | | | Gogs / Forgejo / Codeberg | | | | "gitea" . Gitea Gogs . | | | |Forgejo Gitea . Codeberg Forgejo . API nvchecker . | | | | "git" . | | | | BitBucket | | | |0.0 | | | |3.5 | | | | | | | |source = "bitbucket" | | | | | | | | | | | |168u | | | | | | | |168u | | | |BitBucket . %Y%m%d 20130701 use_max_tag . . | | | |0.0 | | | | | | | |bitbucket | | | | bitbucket / lilydjwg/dotvim. | | | | | | | |branch | | | | : . | | | | | | | |use_max_tag | | | | true BitBucket . pkg_resources.parse_version . . | | | | | | | |use_sorted_tags | | | | true query sort . . | | | | | | | |query | | | | use_sorted_tags ( ). (escape) . | | | | | | | |sort | | | | use_sorted_tags ( ). -target.date ( ). | | | | | | | |max_page | | | | 3 . use_max_tag . | | | | | | | |168u | | | | use_max_tag use_sorted_tags List Options ..SS GitLab | | | |0.0 | | | |3.5 | | | | | | | |source = "gitlab" | | | | | | | | | | | |168u | | | | | | | |168u | | | | GitLab . %Y%m%d 20130701 | | | | use_max_tag . . | | | |0.0 | | | | | | | |gitlab | | | | gitlab Deepin/deepin-music. | | | | | | | |branch | | | | | | | | | | | |use_max_tag | | | | true (max tag) GitLab . pkg_resources.parse_version . . | | | | | | | |host | | | | (hostname) (self-hosted) . | | | | | | | |token | | | | GitLab API. | | | | | | | |168u | | | | : | | | |0.0 | | | |o 2 | | | | token | | | |o 2 | | | | keyfile ( gitlab.com) | | | |o 2 | | | | netrc | | | | | | | |168u | | | | use_max_tag List Options . | | | | RichResult | | | | API RichResult . API . | | | |box center; | | | |l|l|l. | | | | | creation_time | revision_creation_time | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ | | 0.0 o 2 168u | | | | | | | | | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ |use_max_tag | | | | | | | | | | | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------+------------------------+ PyPI source = "pypi" PyPI . (yanked) . pypi PyPI PySide. use_pre_release . false . List Options . RichResult: +----------------------+--------------------------+------------------------+ | | creation_time | revision_creation_time | +----------------------+--------------------------+------------------------+ | | | 0.0 o 2 168u | | | | | | | | | | | | | | | | | | | | | +----------------------+--------------------------+------------------------+ : "packaging" . pip install 'nvchecker[pypi]' . source = "gems" RubyGems . gems RubyGems sass. List Options . NPM Registry source = "npm" NPM Registry . npm NPM Registry coffee-script. . : [__config__.source.npm] registry = "https://registry.npm.taobao.org" Hackage source = "hackage" Hackage . hackage Hackage pandoc. Maven source = "maven" Maven . repo (URL) (: https://repo1.maven.org/maven2). group (group) . artifact (artifact) . source = "cpan" MetaCPAN . cpan CPAN YAML. CRAN source = "cran" CRAN . cran CRAN xml2. Packagist source = "packagist" Packagist . packagist Packagist monolog/monolog. crates.io source = "cratesio" crates.io . (yanked) . cratesio crate crates.io tokio. use_pre_release (pre release). false . List Options . Pacman source = "pacman" nvchecker Arch Linux Pacman . pacman . strip_release (release). source = "archpkg" Arch Linux pacman Pacman . archpkg Arch Linux. strip_release (release) - . provided (provides) . strip_release . . Debian Linux source = "debianpkg" Debian Linux apt APT . debianpkg (source package) Debian Linux. suite Debian ( jessie wheezy : sid). strip_release (release). Ubuntu Linux source = "ubuntupkg" Ubuntu Linux apt APT . ubuntupkg (source package) Ubuntu Linux. suite Ubuntu ( xenial zesty : None suite ). strip_release (release). Repology source = "repology" Repology (repology.org) . repology project . repo (repo). . subrepo (subrepo). . subrepo . List Options ..SS " Anitya" source = "anitya" Anitya (release-monitoring.org) . anitya distro/package distro "fedora" "arch linux" "gentoo" . package . anitya_id / anitya. anitya anitya_id anitya_id . Android SDK source = "android_sdk" Android SDK sdkmanager --list . android_sdk . path XML SDK . . repo addon package . addon2-1.xml addon repository2-1.xml package . channel stable beta dev canary . . beta,dev,canary . stable . host_os linux macosx windows . linux . ( JAR ) . List Options . Sparkle source = "sparkle" macOS Sparkle . sparkle (URL) appcast sparkle. release_notes_language ( en / ). Pagure source = "pagure" Pagure . pagure (namespace). host src.fedoraproject.org. (tags) List Options ..SS APT source = "apt" APT apt APT . pkg APT. srcpkg () APT. mirror (URL) . suite APT ( jessie wheezy ) repo APT ( main contrib main ) arch (i386 amd64 amd64 ) strip_release (release). pkg srcpkg ( ) pkg . RPM source = "rpmrepo" RPM repomd ( dnf Fedora RHEL AlmaLinux zypper openSUSE) RPM . pkg RPM ( rpmrepo pkg ) repo (URL) ( repodata/repomd.xml ) arch RPM (binary src any x86_64 aarch64 binary ) List Options . : lxml . 3.14 zstandard . pip install 'nvchecker[rpmrepo]' . Git source = "git" () git github . git (URL) Git. use_commit . branch use_commit (true) . (use_commit ) List Options ..SS Git git pygit2 source = "git_pygit2" git git pygit2/libgit2 . . git URL Git. username HTTP. password_key keyfile . use_commit . branch use_commit (true) . GitHub: source = "git_pygit2" git = "https://github.com/example/private-repo.git" username = "x-access-token" password_key = "github" (use_commit ) List Options . : pygit2 . Git git Dulwich : WARNING/2 (usage.rst:, line 1040) . Check Git repository without git CLI using Dulwich ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ source = "git_dulwich" git git Dulwich . . . git URL Git. username HTTP. password_key keyfile . use_commit . branch use_commit (true) . GitHub: source = "git_dulwich" git = "https://github.com/example/private-repo.git" username = "x-access-token" password_key = "github" (use_commit ) List Options . : dulwich . source = "mercurial" mercurial (hg) . mercurial (URL) Mercurial. List Options . source = "container" Docker . container ( ) . Docker library/ ( library/python). ( ) . registry . : docker.io registry container pull . docker . docker.io library/ . : +----------------------------------------+-----------+---------------------------------+ | pull | registry | container | +----------------------------------------+-----------+---------------------------------+ |docker pull | quay.io | prometheus/node-exporter | |quay.io/prometheus/node-exporter | | | +----------------------------------------+-----------+---------------------------------+ |docker pull | quay.io | prometheus/node-exporter:master | |quay.io/prometheus/node-exporter:master | | | +----------------------------------------+-----------+---------------------------------+ |docker pull openeuler/openeuler | docker.io | openeuler/openeuler | +----------------------------------------+-----------+---------------------------------+ |docker pull | docker.io | openeuler/openeuler:20.03-lts | |openeuler/openeuler:20.03-lts | | | +----------------------------------------+-----------+---------------------------------+ |docker pull python | docker.io | library/python | +----------------------------------------+-----------+---------------------------------+ |docker pull python:3.11 | docker.io | library/python:3.11 | +----------------------------------------+-----------+---------------------------------+ List Options ..SS ALPM source = "alpm" ALPM. alpm . repo . nvchecker repos . repos nvchecker . core extra multilib . dbpath ALPM. : /var/lib/pacman. . strip_release (release) - . provided . (provides) strip_release . . : "pyalpm" . ALPM source = "alpmfiles" ALPM. . provides . pkgname . filename . . . . usr/lib/libuv\\.so\\.([^.]+) (major) libuv . repo . . strip_dir . false . dbpath ALPM. : /var/lib/pacman. pacman -Fy . pacman -Flq ... . pacman: [__config__.source.alpmfiles] concurrency = 2 2 . pacman -Flq ... . Open Vsx source = "openvsx" Open Vsx . openvsx (Unique Identifier) open-vsx.org ritwickdey.LiveServer. source = "vsmarketplace" Visual Studio Code Marketplace . vsmarketplace marketplace.visualstudio.com/vscode ritwickdey.LiveServer. Go source = "go" Go . go Go github.com/caddyserver/caddy/v2/cmd. opam source = "opam" opam opam . pkg opam repo (URL) ( https://opam.ocaml.org ) List Options . Snapcraft source = "snapcraft" Snapcraft . snap snap. channel . source = "combiner" . from . format . : [entry-1] source = "cmd" cmd = "echo 1" [entry-2] source = "cmd" cmd = "echo 2" [entry-3] source = "combiner" from = ["entry-1", "entry-2"] format = "$1-$2" source = "manual" ( ). manual . . plugin . 2.22 2026-08-15 nvchecker(1)