Difference between revisions of "Chrome OS"

From Mudlet
Jump to navigation Jump to search
(creating page about running Mudlet in Chrome OS)
 
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
== Chrome OS devices that can run Mudlet ==
 +
Mudlet is not available as a web application, but Chrome OS can run Linux programs.  Not all Chrome OS devices support Linux (beta), but recent models should support it.  Devices older than 2019 need to be on the [https://www.chromium.org/chromium-os/chrome-os-systems-supporting-linux list of systems] that would support it.
 +
 
== Steps to run Mudlet on Chrome OS ==
 
== Steps to run Mudlet on Chrome OS ==
  
 
# Enable Linux (beta) on your Chromebook.
 
# 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 [https://www.chromium.org/chromium-os/chrome-os-systems-supporting-linux list of systems] that would support it.
 
 
##At the bottom right, click the time.
 
##At the bottom right, click the time.
 
##Click the gear icon for Settings.
 
##Click the gear icon for Settings.
Line 9: Line 11:
 
##Follow the steps. Setup can take 10 minutes or more.
 
##Follow the steps. Setup can take 10 minutes or more.
 
#Download the latest version of Mudlet and place it into the Linux container.
 
#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 [[Compiling_Mudlet#Compiling_on_Chrome_OS|compiled from source]] instead.
 
 
##Go to the [https://www.mudlet.org/download/ Mudlet download page]
 
##Go to the [https://www.mudlet.org/download/ Mudlet download page]
 
##Click the Linux tab and find the .tar file.
 
##Click the Linux tab and find the .tar file.
##Right-click the link, "Save link as...", choose "Linux files" on the left and save it there inside of the Linux container.
+
##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.
##Open the Terminal app, use <code>ls</code> to verify that your file is where you expected
+
##Open the Terminal app, use <code>cd mudlet</code> to change directory and then list files with <code>ls</code> to verify that your file is where you expected.
##Extract the file with a command like<code>tar -xvzf Mudlet-4.9.1-linux-x64.AppImage.tar</code>, adjusting the file name for whatever version is current.
+
##If that is the only file in the directory, <code>tar xf *.tar</code> will extract the file.  Then <code>ls</code> should show your .tar file and the "Mudlet.AppImage" file. You are finished with the .tar file, <code>rm *.tar</code> will remove it.
##Start the program by typing <code>./Mudlet.AppImage</code>
+
##Start the program by typing <code>./Mudlet.AppImage</code> (exact capitalisation)
##*Note: If started from the Terminal in this way, keep the Terminal open until after you're finished.
+
##*If started from the Terminal in this way, keep the Terminal open until after you're finished.
#Make a shortcut.
+
##*If you get the message <code>cannot execute binary file: Exec format error</code> then this way of running Mudlet won't work, but [[Compiling Mudlet#Compiling on Chrome OS|another way will]].
##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.
+
##*Having trouble? [https://www.mudlet.org/chat We are glad to help].
##In Terminal, type <code>sudo pico /usr/share/applications/mudlet.desktop</code> to start an editor, paste this block of text, changing the folder locations for wherever you placed the 2 files:
+
 
##:<pre>
+
== Making a shortcut ==
##::[Desktop Entry]
+
<ol>
##::Type=Application
+
<li>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 <code>mudlet.png</code>.</li>
##::Exec=/home/YOURNAME/mudlet/Mudlet.AppImage
+
<li>In Terminal, type <code>sudo apt install nano</code> to install an editor.  Use <code>sudo nano /usr/share/applications/mudlet.desktop</code> 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":
##::Name=Mudlet
+
<pre>
##::Icon=/home/YOURNAME/.icons/mudlet_main_512x512.png</pre>
+
[Desktop Entry]
##Use Ctrl-X to exit the pico editor, and save changes.
+
Type=Application
##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.
+
Exec=/home/YOURNAME/mudlet/Mudlet.AppImage
##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.
+
Name=Mudlet
 +
Icon=/home/YOURNAME/mudlet/mudlet.png</pre>
 +
</li>
 +
<li>Use Ctrl-X to exit the nano editor.  "Y" to save, it will ask for file name, just press enter to confirm.</li>
 +
<li>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.</li>
 +
<li>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.</li>
 +
</ol>

Latest revision as of 13:30, 27 March 2023

Chrome OS devices that can run Mudlet

Mudlet is not available as a web application, but Chrome OS can run Linux programs. Not all Chrome OS devices support Linux (beta), but recent models should support it. Devices older than 2019 need to be on the list of systems that would support it.

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.
    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 (exact capitalisation)
      • If started from the Terminal in this way, keep the Terminal open until after you're finished.
      • If you get the message cannot execute binary file: Exec format error then this way of running Mudlet won't work, but another way will.
      • Having trouble? We are glad to help.

Making 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.