Skip to content

This repo can be used as a template to create Cinnamon applets with Typescript and webpack support (which allows to use node packages).

License

Notifications You must be signed in to change notification settings

jonath92/cinnamon-template-applet

Repository files navigation

This repo can be used as a template to create Cinnamon applets with Typescript and webpack support (which allows to use node packages)

Installation

  1. Clone this repo into a folder with the name pattern [appletName]@[authorName] e.g.
git clone [email protected]:jonath92/cinnamon-template-applet.git myApplet@jonath92

❗ The naming convention must be retained as the build process otherwilse won't work

  1. change into the directory:
cd [appletName]@[authorName]
  1. Install the node dependencies
npm i
  1. Insall xdotool:
sudo apt install xdotool
  1. Build the applet
npm run build
  1. Open the Cinnamon Applets Dialogue and search for [appletName]@[authorName]

screenshot

Configuration

The three files created in the files/appletName]@[authorName] will be overwritten each time calling the command npm run build and therefore should be untouched.

For setting the Applet metadata (e.g. the name and description shown in the Cinnamon Applets Dialogue) change the variables in the webpack.config.js file.

It is no problem to add more files (such as a icon.png which is required to publish the applet) to the files/appletName]@[authorName] directory - all files excepct from the three auto generated files will be untouched when running the build command.

It is also no problem to rename the applet by changing the parent direcoty name. In that case it will be generated a new directory inside the files directory when running npm run build. However additional files added to the files/appletName]@[authorName] directory must be copied to the new folder manually and also the old directory must be deleted manually (therefore it might be necessary to run the build command twice to fully apply the changes)

About

This repo can be used as a template to create Cinnamon applets with Typescript and webpack support (which allows to use node packages).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published