[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/base32 e9c9329661 033/103: Prepare for package archive inc
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/base32 e9c9329661 033/103: Prepare for package archive inclusion |
Date: |
Sat, 10 Feb 2024 13:00:04 -0500 (EST) |
branch: elpa/base32
commit e9c93296615551da2a0594014affadfacda9d312
Author: Vivek Das Mohapatra <vivek@collabora.co.uk>
Commit: Vivek Das Mohapatra <vivek@collabora.co.uk>
Prepare for package archive inclusion
---
README | 40 ++++++++++++++++++++++++++++++++++++++++
totp.el | 6 +++++-
2 files changed, 45 insertions(+), 1 deletion(-)
diff --git a/README b/README
new file mode 100644
index 0000000000..17bc655506
--- /dev/null
+++ b/README
@@ -0,0 +1,40 @@
+totp.el - Time-based One Time Password support for emacs
+
+This package generates RFC6238 Time-based One Time Passwords
+and displays them (as well as optionally copying them to
+the clipbpoard/primary selection), updating them as they expire.
+
+It stores and retrieves the shared secrets used to generate TOTP
+tokens based on ‘auth-sources’ and/or the freedesktop secrets API
+(aka Gnome Keyring or KWallet).
+
+You can call it with the command ‘totp’, ie:
+
+ M-x totp RET
+
+You can tab-complete based on the label of the secret and a
+buffer displaying the token will be displayed (and updated as
+the displayed token expires).
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
+If you want to import TOTP secrets from other apps you can call:
+
+ M-x totp-import-file RET
+
+This supports:
+
+ - simple base32 encoded TOTP secrets (max 1 per file)
+ - otpauth:// scheme URLs in a text file (any number per file)
+ - otpauth-migration:// scheme URLs in a text file (any number per file)
+ - a mix of the above URL schemes in a text file
+ - QR codes encoding any mix of the URL schemes above
+
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+Your secrets can be fetched from any auth-source source.
+
+Your secrets will only ever be stored by this package in
+auth-source backends that are encrypted.
+
+You secret(s) are only held in memory while a TOTP is being
+generated, or while a TOTP display buffer is being updated.
diff --git a/totp.el b/totp.el
index 117cfe5728..e8788e36a0 100644
--- a/totp.el
+++ b/totp.el
@@ -3,7 +3,10 @@
;; SPDX-License-Identifier: GPL-3.0-or-later
;; Author: Vivek Das Mohapatra <vivek@etla.org>
-;; Keywords: 2FA two-factor totp otp
+;; Keywords: 2FA two-factor totp otp password
+;; URL: https://gitlab.com/fledermaus/totp.el
+;; Version: 0.1
+;; Package-Requires: ((emacs "27.1"))
;;; Commentary:
;; Import TOTP secrets, store and fetch them from auth-sources, and
@@ -577,6 +580,7 @@ OTP and TOKEN are used internally and need not be passed."
(pop-to-buffer ui-buffer)
(run-with-timer 0 1 #'totp-update-token-display ui-buffer)))
+;;;###autoload
(defun totp (&optional secret label)
"Generate a TOTP token for SECRET, identified by LABEL, and show it."
(interactive
- [nongnu] elpa/base32 4432d44bce 012/103: Trivia: clean up some docstrings, (continued)
- [nongnu] elpa/base32 4432d44bce 012/103: Trivia: clean up some docstrings, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 a683df1a74 013/103: Add a separate instance of an `auth-sources' list just for TOTP, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 5c902928f7 017/103: Fix bug in otpauth-migration URL decoder, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 f27043d432 019/103: Fix some byte compilation warnings, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 417a3d03f6 020/103: Dedup secrets manually instead of relying on freedesktop secrets API, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 800de931a0 023/103: Autoload totp-import-file and update its docstring, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 3e5a779479 022/103: Reduce totp-minimum-ui-grace default value to 3 from 5, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 0feadbc485 025/103: Make the cancel-this-timer function more generic, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 94f41a945e 028/103: Implement auto-copying of TOTP tokens, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 a61f9c27b1 032/103: Remove unnecessary file, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 e9c9329661 033/103: Prepare for package archive inclusion,
ELPA Syncer <=
- [nongnu] elpa/base32 e18cb077d7 035/103: Note in TODO that we may be able to drop custom hmac support now, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 ff7061d7ef 036/103: Bump version to 0.2 for release attempt, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 1e14f7c45f 016/103: Remove references to debug function that doesn't exist anymore, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 c29822d2f1 015/103: Add totp-pkg.el in preparation for publishing to a package archive, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 47bcc107b8 021/103: Enable substring matching for TOTP secret selection, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 9b6ac038a1 018/103: Eliminate reference to obsolete internal variable in an error path, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 8925afa85b 027/103: Clarify that totp-alt-xdg-schemas is used only to read secrets, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 982c418361 026/103: Docstring style trivia, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 0741c352da 031/103: Add .gitignore, ELPA Syncer, 2024/02/10
- [nongnu] elpa/base32 cf6483b7fa 030/103: Update docstrings and comments for checkdoc compliance., ELPA Syncer, 2024/02/10