# Integrating AppImage Fritzing 1.0.4 correctly into GNOME

**URL:** <https://forum.fritzing.org/t/integrating-appimage-fritzing-1-0-4-correctly-into-gnome/27241>\
**Category:** Tutorials - Guides - How to's - & Experiences.\
**Created:** [February 20, 2025, 2:52pm UTC](https://forum.fritzing.org/t/integrating-appimage-fritzing-1-0-4-correctly-into-gnome/27241 "2025-02-20T14:52:15Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Harald\_Rau](https://forum.fritzing.org/user_avatar/forum.fritzing.org/harald_rau/32/21072_2.png) [@Harald\_Rau](https://forum.fritzing.org/u/Harald_Rau)\
**Post date:** [February 20, 2025, 2:52pm UTC](https://forum.fritzing.org/t/integrating-appimage-fritzing-1-0-4-correctly-into-gnome/27241/1 "2025-02-20T14:52:15Z")

</div>

Hallo,  
ich hatte immer ein Problem mit der Installation des AppImage unter Ubuntu und Debian. Eine Installation ist ja eigentlich nicht nötig, aber eine sabere Einbindung in die Desktopumgebung mit GNOME.

Bei Mint oder anderenOberflächen kann das durchaus anders sein.

Hier die Vorgehensweise die bei mir zum Erfolg geführt hat:

**1. Erstellen der MIME Type Datei x-fritzing.xml für die Zuordnung eines neuen MIME Type**

```auto
<?xml version="1.0"?>
<mime-info xmlns='http://www.freedesktop.org/standards/shared-mime-info'>
	<mime-type type="application/x-fritzing">
		<comment>Textfile with Fritzing</comment>
		<glob pattern="*.fz"/>
		<glob pattern="*.fzz"/>
		<glob pattern="*.fzpz"/>
		<glob pattern="*.fzb"/>
		<glob pattern="*.fzbz"/>
		<icon name="application-x-fritzing"/>
	</mime-type>
</mime-info>

```

**2. Installieren des neuen MIME Type**

```auto
xdg-mime install x-fritzing.xml

```

**3. Icon installieren**

Das Icon habe ich mir aus dem AppImage extrahiert.

```auto
xdg-icon-resource install --context mimetypes --size 64 fritzing_64.png application-x-fritzing
xdg-icon-resource install --context mimetypes --size 128 fritzing_128.png application-x-fritzing
xdg-icon-resource install --context mimetypes --size 256 fritzing_256.png application-x-fritzing

```

**4. fritzing.desktop-Datei als Starter einrichten**

```auto
xdg-mime default arduino.desktop application/x-fritzing

```

hier die Datei ~/.local/share/applications/fritzing.desktop

```auto
[Desktop Entry]
Version=1.1
Type=Application
Name=Fritzing
Comment=Fritzing
Icon=/home/hara/Software/AppImage/fritzing/fritzing.svg
Exec=/home/hara/Software/AppImage/fritzing/fritzing.AppImage
Actions=
MimeType=application/x-fritzing;
Categories=Development;
StartupNotify=true

```

**5. Jetzt müssen die Icons noch nach _Adwaita_ verlinkt werden.**

```auto
sudo ln -s ~/.local/share/icons/hicolor/64x64/mimetypes/application-x-fritzing.png /usr/share/icons/Adwaita/64x64/mimetypes/application-x-fritzing.png

sudo ln -s ~/.local/share/icons/hicolor/256x256/mimetypes/application-x-fritzing.png /usr/share/icons/Adwaita/256x256/mimetypes/application-x-fritzing.png

sudo gtk-update-icon-cache /usr/share/icons/Adwaita

```

Das hat bei mir geholfen. Kann das jemand bestätigen?

Gruß Harald!

# **Durch Chat GPT nach Englisch**

* * *

# **How to Integrate Fritzing AppImage into GNOME on Ubuntu/Debian**

Hi everyone,

I always had issues properly integrating the **Fritzing AppImage** into my desktop environment on **Ubuntu and Debian**. While AppImages don’t require installation, a clean integration with GNOME is necessary for a seamless experience.

This guide may differ for other desktop environments like Linux Mint or KDE.

Here is the **step-by-step method** that finally worked for me:

* * *

## **1️⃣ Create the MIME Type File (`x-fritzing.xml`)**

This file defines a new MIME type for Fritzing-related file formats:

```xml
<?xml version="1.0"?>
<mime-info xmlns='http://www.freedesktop.org/standards/shared-mime-info'>
    <mime-type type="application/x-fritzing">
        <comment>Fritzing project file</comment>
        <glob pattern="*.fz"/>
        <glob pattern="*.fzz"/>
        <glob pattern="*.fzpz"/>
        <glob pattern="*.fzb"/>
        <glob pattern="*.fzbz"/>
        <icon name="application-x-fritzing"/>
    </mime-type>
</mime-info>

```

This configuration ensures that **`.fz`, `.fzz`, `.fzpz`, `.fzb`, and `.fzbz`** files are recognized as Fritzing project files.

* * *

## **2️⃣ Install the New MIME Type**

Run the following command to install the MIME type:

```bash
xdg-mime install x-fritzing.xml

```

* * *

## **3️⃣ Install the Icon**

I extracted the icon from the **Fritzing AppImage** and installed it with:

```bash
xdg-icon-resource install --context mimetypes --size 64 fritzing_64.png application-x-fritzing
xdg-icon-resource install --context mimetypes --size 128 fritzing_128.png application-x-fritzing
xdg-icon-resource install --context mimetypes --size 256 fritzing_256.png application-x-fritzing

```

This registers the icon in different sizes for better appearance across the system.

* * *

## **4️⃣ Create the `fritzing.desktop` Launcher**

First, associate Fritzing as the default application for its file type:

```bash
xdg-mime default fritzing.desktop application/x-fritzing

```

Then, create the file **`~/.local/share/applications/fritzing.desktop`** with the following content:

```ini
[Desktop Entry]
Version=1.1
Type=Application
Name=Fritzing
Comment=Fritzing
Icon=/home/user/Software/AppImage/fritzing/fritzing.svg
Exec=/home/user/Software/AppImage/fritzing/fritzing.AppImage
Actions=
MimeType=application/x-fritzing;
Categories=Development;
StartupNotify=true

```

📌 **Replace `/home/user/Software/AppImage/fritzing/`** with the actual path to your **Fritzing AppImage** and **icon file**.

* * *

## **5️⃣ Link Icons to Adwaita (Critical Step!)**

GNOME might not display the correct icons unless they are linked to the **Adwaita** icon theme:

```bash
sudo ln -s ~/.local/share/icons/hicolor/64x64/mimetypes/application-x-fritzing.png /usr/share/icons/Adwaita/64x64/mimetypes/application-x-fritzing.png

sudo ln -s ~/.local/share/icons/hicolor/256x256/mimetypes/application-x-fritzing.png /usr/share/icons/Adwaita/256x256/mimetypes/application-x-fritzing.png

sudo gtk-update-icon-cache /usr/share/icons/Adwaita

```

* * *

Can anyone confirm if this works for them?

Best regards,  
**Harald**

---

<div class="post-metadata">

**Author:** ![Harald\_Rau](https://forum.fritzing.org/user_avatar/forum.fritzing.org/harald_rau/32/21072_2.png) [@Harald\_Rau](https://forum.fritzing.org/u/Harald_Rau)\
**Post date:** [March 13, 2025, 8:46am UTC](https://forum.fritzing.org/t/integrating-appimage-fritzing-1-0-4-correctly-into-gnome/27241/2 "2025-03-13T08:46:48Z")

</div>

I have uploaded the steps to GitHub again and will continue working on the Bash script so that it can be used for installation on the computer.

[https://github.com/HaraldRau/fritzing2gnome](https://github.com/HaraldRau/fritzing2gnome)

Gruß Harald!