OpenAsar/README.md

56 lines
2.4 KiB
Markdown
Raw Normal View History

2021-12-09 11:14:14 +00:00
# OpenAsar
2021-12-12 13:09:34 +00:00
**An experimental open-source alternative of Discord desktop's `app.asar`**
2021-12-09 11:25:01 +00:00
## Features
2021-12-21 08:47:12 +00:00
- **:rocket: Startup Speed**: ~2x faster startup times (up to ~4x with experimental config)
- **:chart_with_upwards_trend: Performance**: OpenAsar can make your client feel snappier (scrolling, switching channels, etc)
2021-12-21 08:47:12 +00:00
- **:paintbrush: Splash Theming**: Easy theming for your splash which works with most themes for any client mod
- **:electric_plug: Hotpluggable**: Replace one file and it's installed, that's it (same with uninstall)
2021-12-11 22:55:29 +00:00
- **:gear: Configurable**: Adds many config options for Discord and OpenAsar enhancements (see config section)
2022-01-30 19:26:33 +00:00
- **:feather: Lightweight**: <2% of Discord's original size (9mb -> ~105kb)
- **:shield: No Tracking**: Removes Discord's built-in tracking for crashes and errors in the asar (not app itself)
2021-12-09 11:50:16 +00:00
### See [FAQ](faq.md) for more details
2021-12-13 07:24:41 +00:00
<br>
## [Install Guide](https://github.com/GooseMod/OpenAsar/wiki/Install-Guide)
2021-12-09 22:29:52 +00:00
2021-12-09 22:29:16 +00:00
## Config
You can configure OpenAsar via `settings.json` (found in your Discord app data / user data), under a `openasar` object. Keep in mind most options are defaults for good reason.
### OpenAsar Options
- `quickstart` (bool, default false) - whether to use Quickstart (experimental)
2021-12-16 16:52:25 +00:00
- `themeSync` (bool, default true) - syncs your modded client's theme with splash theming
- `autoupdate` (bool, default true) - whether to autoupdate OpenAsar after Discord startup
- `updatePrompt` (bool, default false) - whether to show update prompt after updating OpenAsar
2022-01-30 20:33:37 +00:00
- `splashText` (bool, default false) - whether to show bottom right version info text in splash
### Extra Discord Options
- `multiInstance` (bool, default false) - whether to enable multi-instance
2021-12-16 16:52:25 +00:00
- `skipStartupUpdateChecks` (bool, default false) - skips startup update checking (Linux-only)
2021-12-09 22:29:16 +00:00
An example of a settings.json with OpenAsar config:
```json
{
"BACKGROUND_COLOR": "#202225",
"IS_MAXIMIZED": false,
"IS_MINIMIZED": false,
"WINDOW_BOUNDS": {
"x": 801,
"y": 22,
"width": 797,
"height": 876
},
"MINIMIZE_TO_TRAY": false,
"OPEN_ON_STARTUP": false,
"openasar": {
"quickstart": true
}
}
2021-12-11 08:13:27 +00:00
```
Additionally there are some environmental variables you can use:
- `OPENASAR_QUICKSTART` (bool, default false) - same as `quickstart` config option
- `OPENASAR_NOSTART` (bool, default false) - if enabled halts starting after splash loads (for splash testing)