Skip to content

Live View

Dave Walker edited this page Jan 28, 2025 · 1 revision

The following forms of the "live view" command are accepted:

  • Create view for all entries
  • GenCreate view for the service with a specified Id
  • Create view for all entries for a service, given its name
  • Create view for a specific service and account combination

Create a Live View for All Entries

To create a live view for all entries in the database, use the following form of the command:

/path/to/OtpGenerator.Terminal --live

Where:

Argument Comments
/path/to/OtpGenerator.Terminal The path to the OTP Generator binary, named "OtpGenerator.Terminal" on MacOS and Linux and "OtpGenerator.Terminal.exe" on Windows

Create a Live View for a Single Service by ID

Each service is assigned a unique "Id" when it's added to the database. This is shown when 2FA codes are generated and when the contents of the database are listed. For example:

Service List

This Id can be used to specify a service for which a live view should be created as follows:

/path/to/OtpGenerator.Terminal --live id

Where:

Argument Comments
/path/to/OtpGenerator.Terminal The path to the OTP Generator binary, named "OtpGenerator.Terminal" on MacOS and Linux and "OtpGenerator.Terminal.exe" on Windows
id The unique Id for the service/account pair

Create a Live View for a Service and Account Pair

To create a live view for a single service/account combination, use the following form of the command:

/path/to/OtpGenerator.Terminal --live "service" "account"

Where:

Argument Comments
/path/to/OtpGenerator.Terminal The path to the OTP Generator binary, named "OtpGenerator.Terminal" on MacOS and Linux and "OtpGenerator.Terminal.exe" on Windows
service The service name
account The account name

Values need only be quoted "..." if they contain special characters or spaces.

Create a Live View for All Accounts for a Service

To creaye a live view for all accounts at a specific service use the following form of the command:

/path/to/OtpGenerator.Terminal --live "service"

Where:

Argument Comments
/path/to/OtpGenerator.Terminal The path to the OTP Generator binary, named "OtpGenerator.Terminal" on MacOS and Linux and "OtpGenerator.Terminal.exe" on Windows
service The service name

Values need only be quoted "..." if they contain special characters or spaces.

Output

For all forms of the command, the output is similar to the following screen shot. Only the number of entries shown may differ.

One-Time TOTP Generation

Control does not immediately pass back to the console. Instead, the application continues running, updating the view once per second and generating new codes as each TOTP expires.

To end live view cleanly, hit the "escape" (ESC) key on the keyboard. The live view will close and the application will exit.

Clone this wiki locally