mirror of
https://github.com/localsend/localsend.git
synced 2026-04-29 03:00:23 -04:00
docs: improve readme maintainability (#365)
This commit is contained in:
46
README.md
46
README.md
@@ -2,7 +2,10 @@
|
||||
|
||||
LocalSend is a free, open-source app that allows you to securely share files and messages with nearby devices over your local network, without needing an internet connection.
|
||||
|
||||
[](https://github.com/localsend/localsend/actions/workflows/ci.yml)
|
||||
[![CI status][ci-badge]][ci-workflow]
|
||||
|
||||
[ci-badge]: https://github.com/localsend/localsend/actions/workflows/ci.yml/badge.svg
|
||||
[ci-workflow]: https://github.com/localsend/localsend/actions/workflows/ci.yml
|
||||
|
||||
Links: [Homepage](https://localsend.org)
|
||||
|
||||
@@ -27,21 +30,34 @@ LocalSend is a cross-platform app that enables secure communication between devi
|
||||
|
||||
## Screenshots
|
||||
|
||||
<img src="https://localsend.org/img/screenshot-iphone.png" alt="iPhone screenshot" height="300"/> <img src="https://localsend.org/img/screenshot-pc.png" alt="PC screenshot" height="300"/>
|
||||
<img src="https://localsend.org/img/screenshot-iphone.png" alt="iPhone screenshot" height="300"/>
|
||||
<img src="https://localsend.org/img/screenshot-pc.png" alt="PC screenshot" height="300"/>
|
||||
|
||||
## Download
|
||||
|
||||
It is recommended to download the app either from an app store or from a package manager because the app does not have auto-update.
|
||||
|
||||
On Windows, the store version is not available anymore: https://github.com/localsend/localsend/issues/220
|
||||
On Windows, the store version is not available anymore: <https://github.com/localsend/localsend/issues/220>
|
||||
|
||||
| Windows | MacOS | Linux | Andoid | iOS | Fire OS |
|
||||
|------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|-------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|-------------------------------------------------------------------|------------------------------------------------|
|
||||
| [Windows Store](https://www.microsoft.com/store/apps/9NCB4Z0TZ6RR) | [App Store](https://apps.apple.com/us/app/localsend/id1661733229) | [Flathub](https://flathub.org/apps/details/org.localsend.localsend_app) | [Play Store](https://play.google.com/store/apps/details?id=org.localsend.localsend_app) | [App Store](https://apps.apple.com/us/app/localsend/id1661733229) | [Amazon](https://www.amazon.com/dp/B0BW6MP732) |
|
||||
| [Winget](https://github.com/microsoft/winget-pkgs/tree/master/manifests/l/LocalSend/LocalSend) | [Homebrew](https://github.com/localsend/homebrew-localsend) | [AUR](https://aur.archlinux.org/packages/localsend-bin) | [F-Droid](https://f-droid.org/packages/org.localsend.localsend_app) | | |
|
||||
| [Scoop](https://github.com/ScoopInstaller/Extras/blob/master/bucket/localsend.json) | [DMG Installer](https://github.com/localsend/localsend/releases) | [AppImage](https://github.com/localsend/localsend/releases) | [APK](https://github.com/localsend/localsend/releases) | | |
|
||||
| [MSIX Installer](https://github.com/localsend/localsend/releases) | | | | | |
|
||||
| [Portable ZIP](https://github.com/localsend/localsend/releases) | | | | | |
|
||||
| Windows | macOS | Linux | Andoid | iOS | Fire OS |
|
||||
| ------------------------ | ----------------------- | ------------------ | -------------- | ------------- | ---------- |
|
||||
| [Windows Store][] | [App Store][] | [Flathub][] | [Play Store][] | [App Store][] | [Amazon][] |
|
||||
| [Winget][] | [Homebrew][] | [AUR][] | [F-Droid][] | | |
|
||||
| [Scoop][] | [DMG Installer][latest] | [AppImage][latest] | [APK][latest] | | |
|
||||
| [MSIX Installer][latest] | | | | | |
|
||||
| [Portable ZIP][latest] | | | | | |
|
||||
|
||||
[windows store]: https://www.microsoft.com/store/apps/9NCB4Z0TZ6RR
|
||||
[app store]: https://apps.apple.com/us/app/localsend/id1661733229
|
||||
[play store]: https://play.google.com/store/apps/details?id=org.localsend.localsend_app
|
||||
[f-droid]: https://f-droid.org/packages/org.localsend.localsend_app
|
||||
[amazon]: https://www.amazon.com/dp/B0BW6MP732
|
||||
[winget]: https://github.com/microsoft/winget-pkgs/tree/master/manifests/l/LocalSend/LocalSend
|
||||
[scoop]: https://github.com/ScoopInstaller/Extras/blob/master/bucket/localsend.json
|
||||
[homebrew]: https://github.com/localsend/homebrew-localsend
|
||||
[flathub]: https://flathub.org/apps/details/org.localsend.localsend_app
|
||||
[aur]: https://aur.archlinux.org/packages/localsend-bin
|
||||
[latest]: https://github.com/localsend/localsend/releases/latest
|
||||
|
||||
## How it Works
|
||||
|
||||
@@ -69,15 +85,18 @@ You can help translating this app to other languages!
|
||||
|
||||
1. Fork this repository
|
||||
2. Choose one
|
||||
- Add missing translations in existing languages: Only update `_missing_translations_<locale>.json` in [assets/i18n](https://github.com/localsend/localsend/tree/main/assets/i18n)
|
||||
- Fix existing translations: Update `strings_<locale>.i18n.json` in [assets/i18n](https://github.com/localsend/localsend/tree/main/assets/i18n)
|
||||
- Add new languages: Create a new file, see also: [locale codes](https://saimana.com/list-of-country-locale-code/).
|
||||
- Add missing translations in existing languages: Only update `_missing_translations_<locale>.json` in [assets/i18n][i18n]
|
||||
- Fix existing translations: Update `strings_<locale>.i18n.json` in [assets/i18n][i18n]
|
||||
- Add new languages: Create a new file, see also: [locale codes][].
|
||||
3. Optional: Re-run this app
|
||||
1. Make sure you have [run](#getting-started) this app once.
|
||||
2. Update translations via `flutter pub run slang`
|
||||
3. Run app via `flutter run`
|
||||
4. Open a pull request
|
||||
|
||||
[i18n]: https://github.com/localsend/localsend/tree/main/assets/i18n
|
||||
[locale codes]: https://saimana.com/list-of-country-locale-code/
|
||||
|
||||
#### _Take note:_ Fields decorated with `@` are not meant to be translated, they are not used in the app in any way, being merely informative text about the file or to give context to the translator.
|
||||
|
||||
### Bug fixes and improvements
|
||||
@@ -156,6 +175,7 @@ appimage-builder --recipe AppImageBuilder.yml
|
||||
Feel free to open a pull request. There is a `snap` branch to play with.
|
||||
|
||||
## Contributors
|
||||
|
||||
<a align="center" href="https://github.com/localsend/localsend/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=localsend/localsend" />
|
||||
</a>
|
||||
|
||||
Reference in New Issue
Block a user