Getting Started - SelyanSel/AppLink GitHub Wiki

💻 Getting Started

This will guide you through the initial setup of AppLink, and starting for the first time the AppLink server.

Requirements

1️⃣ Server setup

  • Once you unzipped into a new folder the latest release here, run the "change_server_settings.bat".
  • Opened, you will be prompted with notepad and a bunch of text. This text is the .env of the server, if you don't know what this means, it's basically the settings of the server. image (should look something like that)
  • We recommand not changing any of the values here (except one), although you can check the full settings meaning here.
  • Change the accessPassword with a password of your choice. This prevents anyone run anything on your computer, without password. Make sure only you know that password, and remember it, you will need it later on.
  • Save and close that notepad window.

2️⃣ First-time run

  • Execute the "start_server.bat" file. You will be prompted with the AppLinkConfigurator app. This app allows you to edit AppLink settings easily.

  • The page below should pop up.

    image

  • Check the two boxes "Always start when AppLink server is offline" and "Always start AppLink silently and press "Start"

  • After all of this, this page should open:

    image
    TIP: If you want the log window, check the "Enable Log Window" checkmark near the "Start/Restart server" button.

  • Click the "Start/Restart Server" button, then press the "Refresh" button near the "INACTIVE" text. A message box saying "Modules needs to be installed..." will pop up. Press OK and wait until the CMD window is closed.

  • When the CMD window is closed, press again the "Start/Restart Server" button. If everything went correctly, the server should start!

  • You can make AppLink work in the background by closing this window:

    image

  • To reopen it, open your Icon Tray and click on the AppLink logo (this one below)

    image

3️⃣ Using AppLink

  • To use AppLink, nothing complicated. Once the server is up and running, you should be able to check it by going to this URL: http://localhost:9989/
  • The page should look like this:

    image

  • If you see this page, congrats! AppLink is now running.
  • AppLink has 2 built-in apps you can now start. To start File Explorer for example, open this URL: http://localhost:9989/api/openApp?name=explorer&pass=1234
  • WARNING: The URL right there only works if you haven't changed the default password! If you did, just change the password at the end of the URL.

✔️ Conclusion

Congrats 🎉 AppLink is up and running on your system (if you followed everything correctly). You can access it with others computers, phones, anything from your local IP. (search on google to know your local ip, it should look like this at the end for example: http://192.168.1.**:9989/api/openApp?name=explorer&pass=1234)

🤔 What next?

⚠️ **GitHub.com Fallback** ⚠️