super-productivity/docs/wiki/2.-How_To.md
Johannes Millan 73c1848ba9 fix(docs): resolve markdown linting errors in all wiki files
- Add top-level headings to all wiki files (MD041)
- Fix heading spacing and blank line issues (MD022, MD012)
- Convert HTML badges to markdown format (MD033)
- Add alt text to images (MD045)
- Fix list indentation and numbering (MD005, MD029, MD032)
- Remove trailing punctuation from headings (MD026)
- Convert emphasis to proper headings (MD036)
- Fix heading level increments (MD001)
- Add trailing newlines to all files (MD047)

This ensures the wiki-sync.yml GitHub Action will pass linting.
All changes maintain the same visual appearance and functionality.

Fixes the lint failures reported in GitHub Action run #21212863659
2026-01-21 18:03:05 +01:00

118 lines
3.5 KiB
Markdown
Executable file

# How-To Guides
## Downloads & Install
### All Platforms
[[../releases|Install from the releases page]].
### Windows
Due to certification issues it's recommended to download the app from the Microsoft Store:
[![Get it from Microsoft Store](https://developer.microsoft.com/store/badges/images/English_get-it-from-MS.png)](https://www.microsoft.com/store/apps/9nhfvg8361tw?cid=storebadge&ocid=badge)
You can also install the app using [Chocolatey](https://community.chocolatey.org/packages/super-productivity):
```powershell
choco install super-productivity
```
### Linux
#### Snap - Most distributions
Install via command-line:
```bash
## stable
sudo snap install superproductivity
## edge channel releases
sudo snap install --channel=edge superproductivity
## it is also recommended to disable updates to the app while it is running:
sudo snap set core experimental.refresh-app-awareness=true
```
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/superproductivity)
### Flatpak - Most distributions
Must install Flatpak first. See [setup instructions for all distributions](https://flathub.org/setup).
Install via command-line:
```bash
## install
flatpak install flathub com.super_productivity.SuperProductivity
## run
flatpak run com.super_productivity.SuperProductivity
```
[![Get it on Flathub](https://flathub.org/api/badge?locale=en)](https://flathub.org/apps/com.super_productivity.SuperProductivity)
### Aur - Arch Linux
```bash
git clone <https://aur.archlinux.org/superproductivity-bin.git>
cd superproductivity-bin
makepkg -si
```
#### AppImage
If you encounter problems, please have a look here:
<https://github.com/super-productivity/super-productivity/issues/3193#issuecomment-2131315513>
### MacOS
Install via [homebrew cask](https://github.com/caskroom/homebrew-cask):
```bash
brew install --cask superproductivity
```
[![App Store Badge](docs/screens/app-store-badge.svg)](https://apps.apple.com/de/app/super-productivity/id1482572463?l=en&mt=12)
### Android
A new version of the Android app is now available with **Connectivity-Free Mode**, allowing you to use the app without an internet connection.
This update offers more flexibility, supporting both fully offline usage and integration with services like WebDAV and Dropbox for syncing. Enjoy a smoother, more reliable experience whether you're online or offline.
Stay tuned for even more exciting updates!
You can find the Android app here:
[![Google Play Badge](docs/screens/google-play-badge.png)](https://play.google.com/store/apps/details?id=com.superproductivity.superproductivity)
[![F-Droid Badge](https://f-droid.org/assets/fdroid-logo-text_S0MUfk_FsnAYL7n2MQye-34IoSNm6QM6xYjDnMqkufo=.svg)](https://f-droid.org/en/packages/com.superproductivity.superproductivity)
The sources can be [[../android|found here]].
#### Restore Data From Backup
##### Standard Method
The backup path should be shown under settings and then "Automatic Backups". You can then import the backup under "Import / Export".
##### Alternative Method: Pre-Clearing Application
In case the app does not properly start (e.g. [inconsistent task state](https://github.com/johannesjo/super-productivity/issues/3052)), the data must be cleared first:
1. locate the backup and possibly make another copy of it (not strictly necessary, but can't hurt :))
2. start the app
3. hit strg+shift+i to open the dev tools
4. go to application/storage
5. hit clear site data
6. hit strg+r to reload the app
7. within SP you go to settings and import the previously located backup