https://github.com/salanileo/immagini

Library and creation tool for .AppImage files
https://github.com/salanileo/immagini

appimages appimagetool gtk python

Last synced: 3 months ago
JSON representation

Library and creation tool for .AppImage files

• Host: GitHub
• URL: https://github.com/salanileo/immagini
• Owner: SalaniLeo
• License: gpl-3.0
• Created: 2023-01-08T23:04:37.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-07-31T12:55:19.000Z (almost 2 years ago)
• Last Synced: 2023-07-31T15:09:10.303Z (almost 2 years ago)
• Topics: appimages, appimagetool, gtk, python
• Language: Python
• Homepage:
• Size: 9.45 MB
• Stars: 24
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
Immagini  


An application made to easily manage and create .AppImage apps


Install



Library


Ways to manage AppImages inside library:


Rename a file

Set a file executable or not

Extract an appimage in a selected location

Delete an AppImage from disk


Create new AppImage

 

 
Create options

 


Delete .AppDir after build has finished

 


Include custom AppRun

 


Folder mode

 

 
Documentation

 

 
Name

 The name can be whatever you like, with every character. Even spaces

 

 


 
Executable

 The executable file is the file you want to execute as .AppImage. 


 With the app default .AppRun you can only execute shell scripts. If you want to include a python script as executable you need to specify the script         runner at the top of the file. 


 Example:

 

  Python

  


 

    #!/bin/python3

    

    import getpass

    user = getpass.getuser()

    print('My name is: ' + user)

 

  

 

 


  Bash

  


 

    #!/bin/sh

    

    echo My name is:

    whoami

 

  

 

 

 Also, if you want to package whole folders see FolderMode

 

 

 
Icon

 The Icon must respect the AppImage icon specifications.


 Selected icons get put in different locations, based on the size and extension of the image.


 The location of the icon is:



 
For png images:

 usr/share/icons/hicolor/{image dimensions}/icon.png

 
For svg images:

 usr/share/icons/hicolor/scalable/icon.svg

 

 
Category and Type

 To see what category and tpye you can add to your AppImage see freedesktop specifications website

 

 
Advanced options

 


 
Folder mode

 This option is still in beta quality, so don't expect much.


 The exe file needs to be inside the selected folder


 Folder mode allow you to package folders inside an AppImage.


 To package folders into an AppImage you have to select the main app executable as the app executable, and then in the foldermode entry     select the app folder.


 Also, it's recommended to use a custom AppRun if you enable this option.

 

 

 

 


 
Custom AppRun

 By enabling 'Custom AppRun' you can package in the application your own custom-made AppRun file.


 it's recommended to use this option if you use folder mode. If packaging only a single file the executable is located in usr/bin/, so for example if you want to create your own apprun the path to the executable should be usr/bin/(exe).


 

 

 


 
Why the name Immagini

 
First of all let's start by sying that I'm italian. 


 The name Immagini is the italian translation for 'images'... you see where I'm going?

 Given that the app is made to manage .AppImage files and I wanted to give a name that has something to do with the app I came up with the name Immagini.


 Next step is making an icon