Chrome OS

Steps to run Mudlet on Chrome OS

1. Enable Linux (beta) on your Chromebook.
   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.
      • Not all Chromebooks support Linux (beta). Recent models should support it. Devices older than 2019 need to be on the list of systems that would support it.
   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.
   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 to place it within the Linux area. It would be a good idea to make its own folder... right-click on "Linux Files" and click "New folder", name it "mudlet". Go into that "mudlet" folder by clicking on it, and save your .tar file in there.
   4. Open the Terminal app, use cd mudlet to change directory and then list files with ls to verify that your file is where you expected.
   5. If that is the only file in the directory, tar xf *.tar will extract the file. Then ls should show your .tar file and the `Mudlet.AppImage` file. You are finished with the .tar file, rm *.tar will remove it.
   6. Start the program by typing ./Mudlet.AppImage
      • If started from the Terminal in this way, keep the Terminal open until after you're finished.
      • If you get an error message, we will be glad to help.
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 in your `mudlet` folder, and name the file mudlet.png.
   2. In Terminal, type sudo apt install nano to install an editor. Use sudo nano /usr/share/applications/mudlet.desktop to start the editor. Paste this block of text by right-clicking within the screen. Change YOURNAME to your user name in the linux system. Your user name is in the title bar of terminal, followed by "@penguin":

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

   3. Use Ctrl-X to exit the nano editor. "Y" to save, it will ask for file name, 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.