Home

Awesome

alisthelper

<p align="center"> <img src="https://github.com/Xmarmalade/alisthelper/assets/16839488/2067509c-756e-48cd-8f20-5ea961f46ef7" width="100" height="100"> </p>

English | įŽ€äŊ“中文 | CODE_OF_CONDUCT

Downloads GitHub release (latest by date including pre-releases)

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

imageimage
imageimage

Alist Helper includes several useful features:

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.

alistalisthelperalist 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:

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.