AppImage structure (symlinks)

Author: yphil-dev

README.md

@@ -38,7 +38,7 @@ Emulsion is **reproducible** - one single config file - and **arcade ready** ; P
 - [**Linux RPM**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x86_64.rpm)
 - [**Linux AppImage**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x86_64.AppImage)
 - [**Linux Arch**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x86_64.pacman)
-- [**FreeBSD**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x86_64.freebsd)
+- [**FreeBSD**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x86_64.freebsd) (untested, working on it)
 - [**Windows**](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x64.exe)
 - [**Mac OS** (testers needed)](https://github.com/yphil-dev/emulsion/releases/latest/download/emulsion_x64.dmg)
 
@@ -86,9 +86,9 @@ Emulsion finds your emulators, helps you install the ones you don’t have, and
 
 ![Emulators management](https://yphil.gitlab.io/images/emulsion-emulators-n64.png?cache=x)
 
-Emulsion is up-to-date on Linux emulators and the way they work (extensions + arguments) ; Smart, [DWIM](https://en.wikipedia.org/wiki/DWIM) & and hassle-free.
+Emulsion keeps up-to-date on platforms emulators and their extensions and arguments.
 
-> ⚠️ **Note**: Automatic emulator installation / selection is currently only available on Linux. On Windows and macOS, emulators must be installed manually. No biggie, the result is the same anyway: setup and forget.
+> ⚠️ **Note**: Automatic emulator installation / selection is currently only available on Linux. On BSD, macOS and Windows, emulators must be installed manually. No biggie, the result is the same anyway: setup and forget.
 
 #### Other OSes
 

build/after-pack.js

@@ -28,19 +28,26 @@ export default async (context) => {
     // Generate XML content
     const xmlContent = `<?xml version="1.0" encoding="UTF-8"?>
 <component type="desktop-application">
-  <id>emulsion.desktop</id>
+  <id>io.gitlab.yphil.emulsion</id>
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>GPL-3.0+</project_license>
   <name>Emulsion</name>
-  <summary>Game collection manager</summary>
+  <developer_name>yPhil</developer_name>
+  <summary>Better gaming throught chemistry</summary>
+  <releases>
+    <release version="${version}" date="${currentDate}"/>
+  </releases>
   <description>
     <p>Display your games collection into responsive galleries, manage game metadata, cover art and emulator configuration. Launch your games in style.</p>
   </description>
+  <launchable type="desktop-id">io.gitlab.yphil.emulsion.desktop</launchable>
+  <url type="homepage">https://yphil.gitlab.io/emulsion/</url>
+  <url type="help">https://gitlab.com/yphil/emulsion</url>
+  <url type="bugtracker">https://gitlab.com/yphil/emulsion/-/issues</url>
   <categories>
-    <category>Utility</category>
-    <category>Game</category>
+    <category>Games</category>
+    <category>Productivity</category>
   </categories>
-  <developer_name>yPhil</developer_name>
-  <license>GPL-3.0+</license>
-  <homepage>https://yphil.gitlab.io/emulsion</homepage>
   <screenshots>
     <screenshot type="default">
       <image>https://yphil.gitlab.io/images/emulsion-screenshot_01.png</image>
@@ -49,9 +56,6 @@ export default async (context) => {
       <image>https://yphil.gitlab.io/images/emulsion-screenshot_02.png</image>
     </screenshot>
   </screenshots>
-  <releases>
-    <release version="${version}" date="${currentDate}"/>
-  </releases>
 </component>`;
 
     // Create metainfo directory if it doesn't exist
@@ -63,4 +67,41 @@ export default async (context) => {
     // Write the XML file
     fs.writeFileSync(targetFile, xmlContent, 'utf8');
     console.log(`  • AppStream metadata OK: ${targetFile} (version: ${version}, date: ${currentDate})`);
+
+    console.log('  • Generating desktop file for AppImage...');
+
+    const applicationsDir = path.join(appOutDir, 'usr', 'share', 'applications');
+    const desktopFile = path.join(applicationsDir, 'io.gitlab.yphil.emulsion.desktop');
+
+    // Generate desktop file content
+    const desktopContent = `[Desktop Entry]
+Name=Emulsion (AppImage)
+Comment=Display your games collection into responsive galleries, manage game metadata, cover art and emulator configuration. Launch your games in style.
+Exec=emulsion
+Icon=emulsion
+StartupNotify=true
+Terminal=false
+Type=Application
+Categories=Games;Productivity;
+`;
+
+    // Create applications directory if it doesn't exist
+    if (!fs.existsSync(applicationsDir)) {
+        fs.mkdirSync(applicationsDir, { recursive: true });
+        console.log(`  • Created directory: ${applicationsDir}`);
+    }
+
+    // Write the desktop file
+    fs.writeFileSync(desktopFile, desktopContent, 'utf8');
+    console.log(`  • Desktop file OK: ${desktopFile}`);
+
+    // Create symlink in the root directory
+    const symlinkPath = path.join(appOutDir, 'io.gitlab.yphil.emulsion.desktop');
+    try {
+        fs.symlinkSync(desktopFile, symlinkPath);
+        console.log(`  • Symlink created: ${symlinkPath} -> ${desktopFile}`);
+    } catch (error) {
+        // Symlink might already exist or fail on some filesystems
+        console.log(`  • Warning: Could not create symlink: ${error.message}`);
+    }
 };

package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "emulsion",
-    "version": "0.10.15",
+    "version": "0.10.16",
     "summary": "Better gaming throught chemistry",
     "description": "Display your games collection into responsive galleries, manage game metadata, cover art and emulator configuration. Launch your games in style.",
     "homepage": "https://yphil.gitlab.io/emulsion",