Chrome OS

Steps to run Mudlet on Chrome OS

1. Enable Linux (beta) on your Chromebook.
   • Not all Chromebooks support Linux (beta). If you don't see these menu options then compare your device with the list of systems that would support it.
   1. At the bottom right, click the time.
   2. Click the gear icon for Settings.
   3. Click "Linux (Beta)" on the left side of the Settings screen.
   4. Click the "Turn on" button.
   5. Follow the steps. Setup can take 10 minutes or more.
2. Download the latest version of Mudlet and place it into the Linux container.
   • If your Chromebook has an Intel processor, you can run the file offered for Linux. If your device has an ARM processor, it will need to be compiled from source instead.
   1. Go to the Mudlet download page
   2. Click the Linux tab and find the .tar file.
   3. Right-click the link, "Save link as...", choose "Linux files" on the left and save it there inside of the Linux container.
   4. Open the Terminal app, use ls to verify that your file is where you expected
   5. Extract the file with a command like tar -xvzf Mudlet-4.9.1-linux-x64.AppImage.tar, adjusting the file name for whatever version is current. (For example, if you downloaded file has a name of Mudlet-4.10.1-linux-x64.AppImage.tar instead, your command will be tar -xvzf Mudlet-4.10.1-linux-x64.AppImage.tar)
   6. Start the program by typing ./Mudlet.AppImage
      • Note: If started from the Terminal in this way, keep the Terminal open until after you're finished.
3. Make a shortcut.
   1. Save the file https://www.mudlet.org/wp-content/uploads/2017/04/mudlet_main_512x512.png inside of the Linux area. I created a hidden folder .icons and placed it in there just to be tidy, but you can put it wherever.
   2. In Terminal, type sudo apt install nano to install an editor, then sudo nano /usr/share/applications/mudlet.desktop to start it, paste this block of text, changing the folder locations for wherever you placed the 2 files:

      [Desktop Entry]
      Type=Application
      Exec=/home/YOURNAME/mudlet/Mudlet.AppImage
      Name=Mudlet
      Icon=/home/YOURNAME/.icons/mudlet_main_512x512.png

   3. Use Ctrl-X to exit the nano editor. "Y" to save, it will ask for file name and just press enter to confirm.
   4. Click the launcher icon at the bottom left corner of the screen, the 'Linux apps' folder should show your new Mudlet icon inside there. Click it and it should run.
   5. Once it is running, you can right click on the icon in the bar at the bottom of the screen and then pin it in the shelf.