Xmarmalade/alisthelper

alisthelper

https://github.com/Xmarmalade/alisthelper/assets/16839488/2067509c-756e-48cd-8f20-5ea961f46ef7

English | 简体中文 | CODE_OF_CONDUCT

https://img.shields.io/badge/language-dart-blue.svg?style=for-the-badge&color=00ACC1 Downloads https://img.shields.io/github/downloads/Xmarmalade/alisthelper/total?style=for-the-badge&color=FF2196 GitHub release (latest by date including pre-releases) https://img.shields.io/github/license/Xmarmalade/alisthelper?style=for-the-badge https://img.shields.io/github/stars/Xmarmalade/alisthelper?style=for-the-badge https://img.shields.io/github/issues/Xmarmalade/alisthelper?style=for-the-badge&color=9C27B0

Alist Helper is an application developed using Flutter, designed to simplify the use of the desktop version of alist/openlist. It can manage alist/openlist, allowing you to easily start and stop the alist/openlist program.

Wait, not only alist/openlist, alisthelper also supports rclone management, mounting alist/openlist as a hard drive for use.

Screenshots

image	image
image	image

Alist Helper includes several useful features:

• Automatic launching of alist/openlist
• Minimizing to the system tray
• Automatic startup on boot, with the option for silent startup
• Quick access to alist/openlist version and administrator information
• Adjustable alist/openlist startup parameters. You can customize the startup parameters to meet your specific needs and preferences.

Free. No tracking. No ads.

Currently, this app is available on Windows and macOS. (You can build it for Linux, but no official support yet.)

Please note that this program does not include the binary files for alist. You will need to download them manually.

Here's a comparison of alisthelper and other solutions.

	alist	alisthelper	alist desktop
Price	🆓 Free	🆓 Free	💰8$/50￥
Startup at boot	🛠️ Needs manual configuration	✅ Supported	✅ Supported
Silent startup	❌ Not supported	✅ Supported	✅ Supported
Accompanied startup	❌ Not supported	✅ Supported	✅ Supported
GUI	❌ Not supported	✅ Supported	✅ Supported
System tray	❌ Not supported	✅ Supported	✅ Supported
Startup parameters	🛠️ Needs manual configuration	✅ Supported	❌ Not supported
Http proxy	🛠️ Needs manual configuration	✅ Supported	❌ Not supported

Getting Started

Wiki (Simplified Chinese language)

Contributing to AlistHelper

AlistHelper is an open-source project, and we welcome contributions from anyone who is interested in helping improve the app. Whether you're a developer, a translator, or a documentation writer, there are many ways to get involved.

Getting Started

If you're interested in contributing code to AlistHelper, you'll need to follow these steps:

Run

Fork the repository and install Flutter.

After you have installed Flutter, then you can start this app by typing the following commands:

flutter pub get
dart run build_runner build
flutter run

Translation

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 lib/i18n
   • Fix existing translations: Update strings_<locale>.i18n.json in lib/i18n
   • Add new languages: Create a new file, see also: locale codes.
3. Optional: Re-run this app
   1. Make sure you have run this app once.
   2. Update translations via dart run build_runner build
   3. Run app via flutter run
4. Open a pull request

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.

Contributing Guidelines

Before you submit a pull request to AlistHelper, please ensure that you have followed these guidelines:

• Code should be well-documented and formatted according to the Dart Style Guide.
• All changes should be covered by tests.
• Commits should be well-written and descriptive, with a clear summary of the changes made and any relevant context.
• Pull requests should target the master branch and include a clear summary of the changes made.

Bug Reports and Feature Requests

If you encounter a bug in AlistHelper or have a feature request, please submit an issue to the issue tracker. Please be sure to provide a clear description of the problem or feature request, along with any relevant context or steps to reproduce the issue.