Preferences holds Asteroboard's own options: how it looks, and which Asterobot it connects to. They're saved in the browser you use, so each browser and each device has its own, and none of them changes anything in Asterobot. Asterobot's settings are on Server > Config instead (The Config page).
In the sidebar, click Preferences. The page has three sections, switched at the top: Appearance, which opens first, Server and Danger zone.
Appearance
Every change applies at once.
| Field | What it changes | Choices | Default |
|---|---|---|---|
| Language | The language of Asteroboard's interface. | English, French, Spanish | Your browser's language, or French when your browser uses another one |
| Color mode | Light or dark interface. | System, Light, Dark | System, which follows your system |
| Primary color | The main accent color. | 17 colors, from Red to Rose | Green |
| Neutral color | The gray tone of text, borders and backgrounds. | Slate, Gray, Zinc, Neutral, Stone, Taupe, Mauve, Mist, Olive | Slate |
| Radius | How rounded the corners of buttons, cards and fields are. | 0, 0.125, 0.25, 0.375, 0.5 |
0.25 |
The language list shows each language in its own name, followed by its name in the current language, such as "Français (French)".
Once you've changed a field, a small button next to it goes back to the default: Use system language for the language, Use default for the colors and the radius. Color mode needs none, since System is one of its choices.
Tour of Asteroboard shows how the language affects game texts on the Game page.
Server
This section tells Asteroboard where your Asterobot is. Without a working address, Asteroboard has nothing to show.
Server URL
The address Asteroboard connects to. It's http://127.0.0.1:8080 by default, which is right when Asterobot runs on the same computer with its default settings.
You rarely have to type it. When you open Asterobot's own address in your browser, http://127.0.0.1:8080 by default, you land on Asteroboard with that address already in Server URL. It replaces whatever the field held, without asking.
To change it by hand:
- Type the address in Server URL, with
http://orhttps://, the computer's address and the port, such ashttp://192.168.1.20:8080. - Press Enter or click outside the field.
Asteroboard connects to the new address right away. It drops what it showed about the previous Asterobot, including the lines of Server > Console, and loads everything again from the new one. Slashes at the end of the address are removed.
You'll need this for Asterobot on another device, on another port, or with HTTPS: see Asteroboard on another device.
Connection
The badge shows the live state of the connection: Connecting…, Connected or Disconnected.
Test connection sends a single request to Asterobot and tells you how it went:
- Server reachable, with the time the round trip took, such as "Round-trip latency: 12ms". If the badge didn't say Connected yet, Asteroboard reconnects right away.
- Server unreachable: Asterobot didn't answer at that address. Check that Asterobot is running and that Server URL is right, then see Asteroboard can't connect.
A test is handy right after you changed the address or restarted Asterobot.
Danger zone
These two buttons clear what Asteroboard keeps in the browser you use, then reload the page. They never touch Asterobot: your bots, accounts, packages and settings stay as they are. Your browser asks you to confirm each one.
Reset offline data
Asteroboard keeps a copy of itself in your browser so it opens quickly and works without an internet connection. Reset offline data deletes that copy and reloads the page, which downloads Asteroboard again. The browser needs an internet connection for that.
- Click Reset offline data.
- Confirm "This clears all offline data cached by Asteroboard and reloads the page. Continue?"
Use it when Asteroboard keeps showing an old version, or behaves oddly after an update. Your preferences and your Server URL stay. If you installed Asteroboard as an app, it stays installed.
The button is greyed out when your browser can't run Asteroboard offline at all. If the reset fails, Asteroboard shows Couldn't reset offline data: "Try again, or clear this site's data from your browser's settings."
Reset preferences
Reset preferences puts Asteroboard's look and layout back to their defaults, then reloads the page.
- Click Reset preferences.
- Confirm "This resets language, appearance and dashboard layout preferences back to their defaults and reloads the page. Continue?"
What each reset clears
| Reset offline data | Reset preferences | |
|---|---|---|
| Language, color mode, colors and radius | Kept | Back to defaults |
| The language of game texts on the Game page | Kept | Back to following Asteroboard's language |
| Sidebar layout: folded or not, and its width | Kept | Back to defaults |
| Server URL | Kept | Kept |
| The level buttons of Server > Console | Kept | Kept |
| Asteroboard's offline copy | Deleted, then downloaded again | Kept |
| Everything in Asterobot | Kept | Kept |
A few other choices are remembered in your browser and kept by both resets, such as the layers of the world map and the volume of the music player. To remove everything Asteroboard stored in a browser, clear the site data of asteroboard.asterobot.net in that browser's settings.