{"id":13648322,"url":"https://github.com/jaymzh/pius","last_synced_at":"2025-10-24T23:31:35.749Z","repository":{"id":31331141,"uuid":"34893704","full_name":"jaymzh/pius","owner":"jaymzh","description":"PGP Individual User Signer","archived":false,"fork":false,"pushed_at":"2024-02-11T14:14:59.000Z","size":371,"stargazers_count":99,"open_issues_count":23,"forks_count":26,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-02-06T16:48:43.209Z","etag":null,"topics":["gnupg","gnupg2","gpg","keys","pgp","python","signing"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jaymzh.png","metadata":{"files":{"readme":"README-keyring-mgr.md","changelog":"Changelog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-05-01T07:36:05.000Z","updated_at":"2025-02-04T04:45:03.000Z","dependencies_parsed_at":"2024-06-19T09:55:09.968Z","dependency_job_id":"dcf3afdc-dddf-457f-a70d-35d8526a4ad1","html_url":"https://github.com/jaymzh/pius","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaymzh%2Fpius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaymzh%2Fpius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaymzh%2Fpius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaymzh%2Fpius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jaymzh","download_url":"https://codeload.github.com/jaymzh/pius/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238044093,"owners_count":19407128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gnupg","gnupg2","gpg","keys","pgp","python","signing"],"created_at":"2024-08-02T01:04:08.544Z","updated_at":"2025-10-24T23:31:35.378Z","avatar_url":"https://github.com/jaymzh.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# PIUS Keyring Manager\n\n## Introduction\n\nThe PIUS Keyring Manager is a tool for people organizing a keysigning party. It\nvastly simplifies the process.\n\nIf you host large PGP Keysigning Parties, manually building the keyring can be\na huge pain. This utility can be pointed at an mbox or CSV file and will find\nkeys or fingerprints, attempt to find keys on keyservers, and email users whose\nkeys cannot be found.\n\nIt is the primary tool I use for managing the SCALE PGP Keysigning party as of\n2011.\n\n## Usage\n\n### Building the keyring\n\nTypically usage would be to save incoming \"RSVP\"s (keys and fingerprints that\nhave been emailed to you), to an mbox folder and then:\n\n```\npius-keyring-mgr build -r \u003cpath_to_keyring\u003e \\\n  -b \u003cpath_to_mbox\u003e -m \u003cyour_email\u003e -p \"Party Name\"\n```\n\nThis will:\n* Find all keys in the mbox and import them to the keyring\n* Find all fingerprints in the mbox and attempt to find them on a keyserver and\nimport them.\n* Email any user who sent a fingerprint whose key cannot be found on a keyserver\n\nIf you're using a system that takes registrations from a web form and can get a\nCSV of information you can have pius-keyring-mgr parse that by passing in:\n\n```\npius-keyring-mgr build -r \u003cpath_to_keyring\u003e \\\n  -b \u003cpath_to_mbox\u003e -m \u003cyour_email\u003e -p \"Party Name\" \\\n  --csv-file \u003cpath_to_csv\u003e -D, -E4 -F5 -N3\n```\n\nThe extra options tell pius-keyring-mgr how to parse your CSV file:\n\n* `-D` is the delimeter\n* `-E` is the field with the user's email\n* `-F` is the field with the user's fingerprint\n* `-N` is the field with the user's name\n\npius-keyring-mgr is smart enough to be run multiple times on the same keyring\nwith a growing mbox or CSV file and do the right thing.\n\nSometimes you may want to stop emailing certain users for some reason, and you\ncan pass in `--ignore-emails` or `--ignore-fingerprints`.\n\n### Pruning the keyring\n\nOnce the party is over and you want to make the keyring available, you'll want\nto run the 'prune' option which will prompt you for each key on the keyring if\nthe person was in attendance. This is so you can prune all the no-shows from\nthe keyring and make it easier for people to use PIUS with your keyring.\n\n```\npius-keyring-mgr prune -r \u003cpath_to_keyring\u003e\n```\n\n### Raw mode\n\nSometimes you may need to do some extra stuff to the keyring. You *could* just\nuse gpg directly on the keyring, but pius-keyring-mgr does a lot of work to keep\nthat keyring from having any effect on your primary keyring or trustdb, so we\nprovide a nice way to use gpg directly through pius-keyring-manager. You can\npass any set of options to the `raw` mode like so:\n\n```\npius-keyring-manager raw -r path/to/keyring.gpg -- --recv-key \u003ckeyid\u003e\n```\n\nEverything after the `--` is passed directly to gpg.\n\n\nPhil Dibowitz\n\nphil@ipom.com\n\nvim:shiftwidth=2:tabstop=2:expandtab:textwidth=80:softtabstop=2:ai:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaymzh%2Fpius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaymzh%2Fpius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaymzh%2Fpius/lists"}