Update README.md (#446)

Add v3 account sample, and added [!TIP] for how to obtain totpSecret. Tidied up some punctuation.
This commit is contained in:
Michael Cammarata
2026-01-12 15:58:39 -05:00
committed by GitHub
parent 97c705cd7f
commit 3375fe6382

View File

@@ -48,7 +48,7 @@ docker compose up -d
``` ```
> [!CAUTION] > [!CAUTION]
> Set `headless` to `true` in the `config.json` when using docker > Set `headless` to `true` in the `config.json` when using docker.
> Additional docker-specific scheduling options are in the `compose.yaml` > Additional docker-specific scheduling options are in the `compose.yaml`
> [!NOTE] > [!NOTE]
@@ -76,7 +76,7 @@ This will launch the script headlessly using `xvfb-run`.
## Configuration Reference ## Configuration Reference
> [!NOTE] > [!NOTE]
> Edit `src/config.json` to customize behavior. Below are all currently available options > Edit `src/config.json` to customize behavior. Below are all currently available options.
> Rebuild the script after all changes. > Rebuild the script after all changes.
### Core ### Core
@@ -155,7 +155,7 @@ This will launch the script headlessly using `xvfb-run`.
> [!WARNING] > [!WARNING]
> **NTFY Users** Set the `webhookLogFilter` to `enabled`, otherwise you will receive push notifications for *all* log lines > **NTFY** users set the `webhookLogFilter` to `enabled`, or you will receive push notifications for *all* logs.
> When enabled, only account start, 2FA codes, and account completion summaries are delivered as push notifcations. > When enabled, only account start, 2FA codes, and account completion summaries are delivered as push notifcations.
> Customize which notifications you receive with the `keywords` options. > Customize which notifications you receive with the `keywords` options.
@@ -163,41 +163,58 @@ This will launch the script headlessly using `xvfb-run`.
## Account Configuration ## Account Configuration
> [!NOTE] > [!WARNING]
> Edit `src/accounts.json`. The file is an **array** of accounts > Edit `src/accounts.json`. The file is a **flat array** of accounts, not `{ "accounts": [ ... ] }`.
> Rebuild the script after all changes. > Rebuild the script after all changes.
```json ```json
[ [
{ {
"email": "email_1", "email": "email_1",
"password": "password_1", "password": "password_1",
"proxy": { "totpSecret": "",
"proxyAxios": true, "recoveryEmail": "",
"url": "", "geoLocale": "auto",
"port": 0, "langCode": "en",
"username": "", "proxy": {
"password": "" "proxyAxios": false,
"url": "",
"port": 0,
"username": "",
"password": ""
},
"saveFingerprint": {
"mobile": false,
"desktop": false
}
},
{
"email": "email_2",
"password": "password_2",
"totpSecret": "",
"recoveryEmail": "",
"geoLocale": "auto",
"langCode": "en",
"proxy": {
"proxyAxios": false,
"url": "",
"port": 0,
"username": "",
"password": ""
},
"saveFingerprint": {
"mobile": false,
"desktop": false
}
} }
},
{
"email": "email_2",
"password": "password_2",
"proxy": {
"proxyAxios": true,
"url": "",
"port": 0,
"username": "",
"password": ""
}
}
] ]
``` ```
**Notes** > [!NOTE]
- The file is a **flat array**, not `{ "accounts": [ ... ] }`. > `geoLocale` uses the default locale of your Microsoft profile. You can overwrite it here with a custom locale.
- Only `email`, `password`, and `proxy` are supported.
- `proxyAxios` enables Axios-level proxying for API requests. > [!TIP]
> When using 2FA login, adding your `totpSecret` will enable the script to automatically generate and enter the timed 6 digit code to login. To get your `totpSecret` in your Microsoft Security settings, click 'Manage how you sign in'. Add Authenticator app, when shown the QR code, select 'enter code manually'. Use this code in the `accounts.json`.
--- ---
## Troubleshooting ## Troubleshooting