Metadata-Version: 2.4
Name: totp-clip
Version: 0.9.5
Summary: Create TOTP authentication code for 2FA and copy it to the clipboard
Author-email: Alberto P <4104972+alberto743@users.noreply.github.com>
License-Expression: MPL-2.0
Project-URL: Homepage, https://github.com/alberto743/totp-gui
Project-URL: Issues, https://github.com/alberto743/totp-gui/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSES/MPL-2.0.txt
Requires-Dist: PyYAML
Requires-Dist: pyotp
Requires-Dist: pyperclip
Dynamic: license-file

<!--
SPDX-FileCopyrightText: 2025 ENEA
SPDX-FileContributor: Alberto P

SPDX-License-Identifier: MPL-2.0
-->

# TOTP-CLIP

Generate TOTP authentication code for 2FA from a configuration stored in a YAML file with secrets in netrc format and copy it to the clipboard.

## Configuration (YAML)
Defaults to `~/totp.yml`.
``` yaml
service_name:
  remote_name: machine item in netrc
  window_title: title of the window showing the OTP
  store_clipboard: Boolean option to either store the OTP in the clipboard
```

## Secret storage (netrc).
Defaults to `~/.netrc`.
``` shell
machine remote_name in corresponding YAML
	login username as show by the TOTP provider
	password secret key provided during the setup of the two-factor authentication
```

Please assure that only the local user may read this file.

## Installation

``` shell
pipx install totp-clip
```

## Usage

``` shell
totp-clip service_name
```

A shortcut may be manually created to launch the command mentioned.
