How to install Porymap on a Chromebook

In this guide, we'll walk you through the process of installing Porymap on your Chromebook. Porymap is a powerful map editor for the open-source Pokémon game engine, pret/pokeemerald. Whether you're a budding game developer or just curious about map creation, this tutorial will help you get started.

What is Porymap?

Porymap is a user-friendly map editor designed specifically for Pokémon game development. It allows creators to design and edit game maps with ease, providing a visual interface for laying out tiles, placing events, and configuring map properties. This tool is particularly useful for those working with the pokeemerald engine, enabling rapid prototyping and development of custom Pokémon games.


Before we begin, ensure that your Chromebook supports Linux apps (Crostini). If you're unsure, you can check our list of Chromebooks with Linux Apps support.

Step-by-Step Installation Guide

Follow these steps carefully to install Porymap on your Chromebook:

1. Enable Linux Apps

If you haven't already enabled Linux apps on your Chromebook, you'll need to do so first. Go to your Chromebook's Settings, click on "Advanced," then "Developers," and finally enable "Linux development environment (Beta)."

2. Open the Terminal

Once Linux is set up, open the Terminal app from your Chromebook's app launcher.

3. Update Package Information

Run the following command to ensure your package information is up to date:

sudo apt update

4. Install Flatpak

Porymap is distributed via Flatpak, so we need to install it first:

sudo apt install flatpak

5. Add Flathub Repository

Add the Flathub repository to access a wide range of Flatpak applications:

sudo flatpak remote-add --if-not-exists flathub

6. Install Porymap

Now, let's install Porymap:

sudo flatpak install flathub io.github.huderlem.porymap

7. Configure Permissions

This step is crucial for Flatpak to function correctly on your Chromebook:

sudo chown root:root /usr/bin/bwrap && sudo chmod u+s /usr/bin/bwrap

8. Launch Porymap

Finally, you can launch Porymap with this command:

flatpak run io.github.huderlem.porymap

Video Tutorial

For a visual guide, check out our step-by-step video tutorial:

Additional Resources

To help you get started with Porymap, we've prepared a Google Doc with additional information and tips.


If you encounter any issues during installation, try the following:

  • Ensure your Chromebook's software is up to date
  • Restart your Chromebook and try the installation process again
  • Check that you have sufficient storage space in your Linux container

If problems persist, feel free to leave a comment on our YouTube video, and we'll be happy to assist you.

Learn More

Interested in diving deeper into Porymap and its capabilities? Check out these resources:


Congratulations! You've successfully installed Porymap on your Chromebook. This powerful tool opens up a world of possibilities for Pokémon game development. Explore its features, experiment with map designs, and let your creativity flourish. Happy mapping!

For more Chromebook tips and tutorials, don't forget to check out our Chromebook comparison and Buyers Guide.