alisthelper

English | 简体中文 | CODE_OF_CONDUCT

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

Maintainer needed for the macOS part of the code. No new macOS-related changes or updates will be accepted until volunteers.

Screenshots

Alist Helper includes several useful features:

• Automatic launching of alist
• Minimizing to the system tray
• Automatic startup on boot, with the option for silent startup
• Quick access to alist version and administrator information
• Adjustable alist 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. Adaptation plans for more platforms are in progress.

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

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.