Skip to main content

ephervex account

Sign in, inspect, and sign out of the Microsoft account

Usage and options​

Sign in, inspect, and sign out of the Microsoft account

Usage: ephervex account [OPTIONS] <COMMAND>

Commands:
  list         List every account this installation has
  add-offline  Add a local account with no credential and no network
  use          Choose which account a launch uses
  remove       Remove one account, deleting only its own stored credential
  login        Sign in with a Microsoft account
  status       Show the signed-in account, without contacting anyone
  refresh      Refresh the stored credential and prove it still works
  logout       Sign out and remove the stored credential
  help         Print this message or the help of the given subcommand(s)

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account list​

List every account this installation has

Usage: ephervex account list [OPTIONS]

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account add-offline​

Add a local account with no credential and no network.

The UUID is derived the way a Minecraft server derives it in offline mode, so a client and its linked test server agree on who the player is.

Usage: ephervex account add-offline [OPTIONS] <NAME>

Arguments:
  <NAME>
          Minecraft player name, 3-16 characters of letters, digits, or `_`

Options:
      --json
          Emit machine-readable JSON where the command supports it

  -h, --help
          Print help (see a summary with '-h')

ephervex account use​

Choose which account a launch uses

Usage: ephervex account use [OPTIONS] <ACCOUNT>

Arguments:
  <ACCOUNT>  Account UUID, or display name if it is unambiguous

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account remove​

Remove one account, deleting only its own stored credential

Usage: ephervex account remove [OPTIONS] <ACCOUNT>

Arguments:
  <ACCOUNT>  Account UUID, or display name if it is unambiguous

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account login​

Sign in with a Microsoft account

Usage: ephervex account login [OPTIONS]

Options:
      --device-code
          Show a code to enter on another device instead of opening a browser.

          The right choice over SSH or on a machine with no desktop.

      --json
          Emit machine-readable JSON where the command supports it

      --no-open
          Do not open a browser automatically; just print the address

      --session-only
          Sign in for this session only when no system keyring is available.

          Without this, a machine with no Secret Service refuses to sign in rather than storing a credential that disappears after exit.

      --timeout <TIMEOUT>
          How long to wait for the sign-in to be completed, in seconds

          [default: 300]

  -h, --help
          Print help (see a summary with '-h')

ephervex account status​

Show the signed-in account, without contacting anyone

Usage: ephervex account status [OPTIONS]

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account refresh​

Refresh the stored credential and prove it still works

Usage: ephervex account refresh [OPTIONS]

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help

ephervex account logout​

Sign out and remove the stored credential

Usage: ephervex account logout [OPTIONS]

Options:
      --json  Emit machine-readable JSON where the command supports it
  -h, --help  Print help