Spices Update

UUID: SpicesUpdate@claudiux
Last edited:
1 day ago 2019-09-20, 05:19 UTC
Last commit: [11e4478a] v4.0.2 - Removes unnecessary notifications (#2588)

Warns you when installed Spices (applets, desklets, extensions, themes) require an update or new Spices are available.

README

Close

Spices Update

Important!

In order to be sure to download the latest version of Spices Update, use this link rather than the Download button at the top of this page.

Summary

Cinnamon Spices are Applets, Desklets, Extensions and Themes.

You usually check updates for the Spices using Cinnamon Settings. But, like me, you do it too seldom.

The Spices Update applet plays these roles:

  • It warns you when the Spices you have installed need updates.
  • Optional: It can also warn you when new Spices are available.
  • It gives you direct access to Cinnamon Settings for Applets, Desklets, Extensions and Themes.

Status

Usable from Cinnamon 2.8 to Cinnamon 4.2.

Fully supported by the author, under continuing development and in continuous use on several machines, running with Linux Mint, Fedora or Archlinux.

From version v3.0.0 ~ 20190808:

  • Spices Update is compatible with Cinnamon 2.8 -> 4.2 (Mint 17.3 -> 19.2).
    • From Cinnamon 3.8 to 4.2 (Mint 19 -> 19.2): Perfectly functional, as usual.
    • From Cinnamon 2.8 to 3.6 (Mint 17.3 -> 18.3): Some features are reduced:
    • The Spices configuration window does not open on the second tab, only on the first one. You will need to click on the second tab and select the sort by date yourself.
    • The Settings window of this applet does not contain any tabs.
    • In the settings of this applet, you can not access Spices lists to disable their monitoring. Therefore, all installed Spices are monitored.
    • The script generate_mo.sh (in the scripts folder) allows you to install all available translations. Restart Cinnamon after execution.
    • If the Symbola_Hinted font can not be automatically installed, then place you into the fonts/symbola folder and double-click on the Symbola_Hinted.ttf file. Install it with the just opened gnome-font-viewer.
    • Cinnamon 2.8: The number of changes does not appear next to the Spices Update icon.

Requirements

The Spices Update requires the notify-send tool and the symbola TrueType font.

To install them:

  • Fedora: sudo dnf install libnotify gdouros-symbola-fonts
  • Arch:
    • sudo pacman -Syu libnotify
    • yay -S ttf-symbola or pamac build ttf-symbola
  • Linux Mint, Ubuntu: sudo apt install libnotify-bin fonts-symbola
  • Debian (without sudo):
    • su
    • apt install libnotify-bin fonts-symbola

This applet helps you to install these dependencies, if needed.

Settings

There are five tabs in settings.

The first, General, allows you to:

  • Select the Time interval between two checks (in hours). Please note that the first check will take place one minute after starting this applet.
  • Select the ways to warn you : changing the appearance (by color changing) of the icon of this applet and/or displaying messages in the notification zone. You can also choose the type of notification: Minimal or With a button to open the Download tab in System Settings. If desired, the notification may contain the description of each update or new Spice.
  • Select the Type of display of the icon: with or without text?
  • Hide the icon applet while nothing is to report. Please note that Spices Update settings are only accessible when the applet icon is visible or by opening the Cinnamon Settings-> Applets.

system_settings_applet

For the content of the other tabs (Applets, Desklets, etc), please look at the screenshot above and note that the list of installed Spices is automatically filled at startup, but a button allows you to reload it.

Set to FALSE all the Spices you do not want to check updates. There are two reasons to do this:

  • A spice is OK for you, and you do not want to be notified of any changes to it.
  • You are a developer working on a spice and you do not want to be informed about changes during development.

Menu

In the menu of this applet:

  • a Refresh button allows you to force checking the availability of updates for your Spices;
  • a dot appears in front of each type of Spice when at least one update is available;
  • a click on a type of Spice (Applets, Desklets, etc) opens the Download tab of the corresponding page in Cinnamon Settings, with Spices sorted by date;
  • when new Spices are available, an option Forget new Spices appears; clicking it will clear these notifications of new spices, until others arrive;
  • a Configure... button opens the Settings.

Icon

The color of the icon changes when at least one of your Spices needs an update.

Its tooltip (the message displayed when the icon is hovered) contains the list of spices to update, if any.

hovering_icon

Notifications

There are two types of notifications: Minimal or With buttons. Each of them may or may not contain details: the reason for an update or the description of a new spice.

Minimal notifications

Here with the reason for update:

notif_simple_with_details

Notifications with buttons

Two buttons: firstly a button to open the System Settings page to download updates; secondly a button to refresh notifications.

notif_with_details

Translations

Any translation is welcome. Thank you for contributing to translate the applet's messages into new languages, or to improve or supplement existing translations.

Available translations and their authors

  • Croatian (hr): muzena
  • Dutch (nl): Jurien (French77)
  • Finnish (fi): MahtiAnkka
  • French (fr): claudiux
  • German (de): Mintulix
  • Italian (it): claudiux
  • Spanish (es): claudiux
  • Swedish (sv): Åke Engelbrektson (eson57)

Many thanks to them!

How to offer a translation

  1. Create an account on Github.
  2. Fork the cinnamon-spices-applets repository.
  3. In your fork, create a branch (named like SpicesUpdate-YOUR_LANGUAGE_CODE) from the master one.
  4. On your computer, install git and poedit.
  5. Clone your branch on your computer: git clone -b SpicesUpdate-YOUR_LANGUAGE_CODE --single-branch https://github.com/YOUR_GITHUB_ACCOUNT/cinnamon-spices-applets.git SpicesUpdate-YOUR_LANGUAGE_CODE
  6. Open the SpicesUpdate@claudiux.pot file (which is in the po directory) with poedit and create your translation. You obtain a YOUR_LANGUAGE_CODE.po file.
  7. On Github, upload this YOUR_LANGUAGE_CODE.po file at the right place into your branch then go to the root of your branch and make a Pull Request.

Installation

Automatic Installation

Use the Applets menu in Cinnamon Settings, or Add Applets to Panel in the context menu (right-click) of your desktop panel. Then go on the Download tab to install this Spices Update applet.

Manual Installation:

  • Install the additional programs required.
  • Download the latest version of Spices Update from the Spices Web Site.
  • Unzip and extract the folder SpicesUpdate@claudiux into ~/.local/share/cinnamon/applets/
  • Enable this applet in System Settings -> Applets.
  • You can also access the Settings Screen from System Settings -> Applets, or from the context menu of this applet (right-clicking on its icon).

A Star to thank the author

If you like this Spices Update applet, please do not offer money or coffee, but log in and click on the Star at the top of this page.

Many Thanks.

CHANGELOG

Open

Log In To Comment!

50 Comments

MarcoB-0049
MarcoB-0049-1 day ago
Hello claudiux, Max Buchholz writes what I can only emphasize and underline! Great work, great tool and many, many thanks for it! Max Buchholz schreibt das, was ich nur betonen und unterstreichen kann! Tolle Arbeit, super Tool und vielen, vielen Dank dafür!
claudiux
claudiux-13 hours ago
Thank you! You encourage me to always do better.
claudiux
claudiux-1 week ago
The version 4.0.0 of Spices Update is here! This applet ensures you to get the latest versions of all the Spices, if you use its menu (clicking on the icon of Spices Update) to update them (only for Cinnamon 3.8 and followings, for the moment). After updating Spices Update, please verify the version number (that must be at least 4.0.0) hovering its icon. If the version number is lesser than 4.0.0, then: 1. Download this zip file https://cinnamon-spices.linuxmint.com/files/applets/SpicesUpdate@claudiux.zip?4fe20058-6c66-4046-9fc2-2ccd14008e55 and save it into your ~/.local/share/cinnamon/applets/ directory. 2. Delete entirely the SpicesUpdate@claudiux folder. 3. Unzip the downloaded zip file. The folder SpicesUpdate@claudiux appears. Delete the zip file. Restart Cinnamon (ctrl-alt-esc) before to use Spices Update. 4. From now, you'll get the latest version of each Spice with Spices Update! Enjoy it!
claudiux
claudiux-6 days ago
Having forgotten some of the code in version 4.0.0, I created version 4.0.1 which fixes this. Please repeat the procedure above with this zip file: https://cinnamon-spices.linuxmint.com/files/applets/SpicesUpdate@claudiux.zip?84e821c1-7ff5-4fd8-a833-f8d399a51582. Restart Cinnamon after doing it. Sorry for the inconvenience.
Max Buchholz
Max Buchholz-1 week ago
This Tool is amazing! It's Open Source, it does what it declares to do, it is well documented, it's well integrated into Cinnamon, allows the user to control s lot of settings and is in continuous development. I wish more software would be like this.
claudiux
claudiux-1 week ago
Thank you very much for this great comment!
LinuxOnTheDesktop
LinuxOnTheDesktop-3 weeks ago
Hello! Perhaps I miss something, but I find it difficult to see what is about to be, and subsequently has been, update. For, I see a '1' on the applet's icon, I use the icon to tell Cinnamon to update, a message flashes by about which applet is at issue - flashes past too fast for me to read - and then the update has been installed, seemingly with no record. Also, getting to this page, as against to the inbuilt help text, is harder than is ideal
claudiux
claudiux-3 weeks ago
Hello! The description of any change is given by the author of the Spice to update. You can read it using the notification applet, or hovering the Spices Update applet icon. If this object is not shown, then click on the Spices Update icon and select 'Refresh'. Sometimes, a Spice needs to be updated only because its author has modified the README.md file to modify the README section like this one on this page. But the author is not responsible for the management of this web site. You give me the idea to log the descriptions of all the updates...
VandenBergh
VandenBergh-3 weeks ago
Great little tool to keep all your favorite spices up to date. Works well on Linux Mint 19.1 & 19.2. A big thank you to "claudiux" the developer.
claudiux
claudiux-1 month ago
Available translations: Dutch, Finnish, French, Italian, German, Hungarian, Spanish and Swedish. A big thank to all the translators! Any new translation is welcome!
claudiux
claudiux-1 month ago
Spices Update v3.0.0 is here! Now, you can also use Spices Update on Cinnamon 2.8, 3.0, 3.2, 3.4 and 3.6! (Mint from 17.3 to 18.3.) Look at CHANGELOG for more details. Enjoy it!
Dragoş
Dragoş-1 month ago
Hello, Claude. Thank you very much for this applet, it's useful and works fine. You got your star up there (at least one from me, at the top of the page :-D ) There are a couple minor issues that you may wanna look into when possible - nothing serious, just aesthetics. 1. When manually restarting Cinnamon, the icon shows up and remains visible although it's set to hide if no updates are available. Maybe you can hook a Cinnamon restart event (or whatever it's called) and review applet's behavior upon that (perform a refresh). Dunno if it's possible - just saying. 2. When an updated (and/or new?) applet/desklet/extension/theme has single quotes in its description, the tooltip in the tray displays those escaped with a backslash. (see here: https://postimg.cc/mPZM9RtM ) No other issues noticed so far. Keep up the good work! :-)
claudiux
claudiux-1 month ago
Hello Dragoş. Many thanks for encouragements and for the star! I can't reproduce the first issue. What is your version of Cinnamon? The version 2.3.1 of SpicesUpdate is coming soon. (I just made the pull request.) It solves the second issue. Regards.
claudiux
claudiux-1 month ago
Now, with Spices Update, you can update all xlets, even if you have installed them using the Download button at the top of their page.
claudiux
claudiux-1 month ago
Using Spices Update is the only one way to do this!
claudiux
claudiux-1 month ago
(to do it, sorry)
claudiux
claudiux-6 months ago
Available translations: Dutch, French, Italian, German, Hungarian, Spanish and Swedish. A big thank to all the translators! Any new translation is welcome!
Footbath666
Footbath666-7 months ago
Running Cinnamon 3.2.7 on Mint 18.1. I've never gotten this to work. Appear to have all dependencies and have also tried installing manually. Any suggestions? glass.log: [Applet "SpicesUpdate@claudiux"]: Error importing applet.js from SpicesUpdate@claudiux .xsession-errors: (soffice:32663): Gdk-WARNING **: gdk_window_set_icon_list: icons too large :1: parser error : Document is empty /* Spices Update (SpicesUpdate@claudiux) ^ :1: parser error : Document is empty /* Spices Update (SpicesUpdate@claudiux)
claudiux
claudiux-7 months ago
It's normal, for the moment. This applet is intended to work with Cinnamon 3.8 or 4.0 (Linux Mint 19 or 19.1). Now that the development is finished, I will make a multi-version (which is more complicated to maintain for me).
GoodGuy98
GoodGuy98-5 months ago
May I suggest you add a comment near the top that this applet only work with Cinnamon 3.8 or 4.0 (Linux Mint 19 or 19.1) at this point in time. How will we know when the multi-version you are working on is available for Linux Mint 18.3 etc?
fluntelion
fluntelion-7 months ago
The last 2 or 3 updates of Spices Update caused a crash of Cinnamon. The message read: "You are now in the recovery mode. Do you want to restart Cinnamon?" Well, I wanted to, and after a few seconds, everything was fine again. - Is this crash 'normal' in the sense of: is it necessary to restart Cinnamon in order to make the updated applet work? Or is it a bug? If so, you may want to know it.
claudiux
claudiux-7 months ago
This occurs sometimes for all applets, when the translation files to update are too big or too numerous.
claudiux
claudiux-7 months ago
Can you open an issue and give me the contents of your ~/.xsession-errors.old file (if you do not have restarted Cinnamon again), please?
fluntelion
fluntelion-7 months ago
Unfortunately I can't. I use BleachBit to have all kinds of crap cleaned. .xsession-errors files belong to what I consider crap (BLUSH), so they're all gone. Sorry. But as you say that such crashes can occur sometimes, I'll take them with equanimity from now on. :-)
claudiux
claudiux-7 months ago
The latest update to Spices Update, which did not contain any .po files, was made without Cinnamon crash.
Draconicrose
Draconicrose-7 months ago
Thank you for adding the ability to hide the icon when there's nothing to update!
fluntelion
fluntelion-7 months ago
Maintenant que je sais que tu es Français, je comprends beaucoup mieux certaines choses: ta gentilesse, ta courtoisie, ta compréhension, ton engagement et la qualité de l'applet - tout cela me fait penser à Clément Lefebvre. ;-) Ce savoir-vivre, célèbre dans le monde entier, c'est bien plus qu'un repas délicieux, non? :-) I did my best to say it in French, but I doubt that 'compréhension' is a good translation of 'obligingness', and I'm afraid that I'm not writing 'Le bon Français'. But you'll understand me nonetheless, won't you?
claudiux
claudiux-7 months ago
Merci pour ce message qui me va droit au cœur ! Et ton français est excellent, bien meilleur que mon anglais ! Tu m'as fait découvrir 'obligingness', qui se traduit plutôt par 'obligeance' ou 'serviabilité'. There are good guys in every country. You prove it, as well as all those here who encourage me and participate by giving me good ideas, by translating this applet, by participating in its improvement. Thank you very much!
fluntelion
fluntelion-7 months ago
I had been waiting for such an applet for years, and here it is. Great! And it works perfectly well. Thank you for your commitment and your work. :-) Let me propose something. Could you give us the choice to have the symbol hidden when there's nothing to be updated? Like the symbol of the Update Manager? That would be even greater.
claudiux
claudiux-7 months ago
Thank you for your compliments! Your wish has been granted. Take a look at https://github.com/linuxmint/cinnamon-spices-applets/pull/2254 ;-)
Jurien
Jurien-7 months ago
Maybe as extra information on this Website tell how Hide the Icon can be undone.(When icon is hidden, this can only be reversed by doing this in the Applet settings. [img]https://i.imgur.com/FhwhQqm.png[/img]
claudiux
claudiux-7 months ago
Good idea. I am going to modify the README.md file to explain that.
fluntelion
fluntelion-7 months ago
Now the applet is greater, but you're the greatest. Thank you very, very much. Here are two translations of "Hide the icon as long as nothing is to report" to German. Both are correct and idomatic, but (1) is a little bit shorter than (2) - just in case. ;-) (1) Icon nur anzeigen, wenn Updates verfügbar sind. (2) Icon verbergen, wenn keine Updates angeboten werden.
Mintulix
Mintulix-7 months ago
Great! I always wanted the download tab to be sorted by date as default (or that the chosen sort order would be saved). Thanks, claudiux!
claudiux
claudiux-7 months ago
Version 1.2.0 is here! Now a click on a type of Spice (Applets, Desklets, etc) in the menu opens the Download tab of the corresponding page in Cinnamon Settings, with Spices sorted by date.
Jurien
Jurien-7 months ago
Very useful applet. Translated by me in Dutch (nl.po) What I wonder is who makes sure that translations of Applets are integrated.
claudiux
claudiux-7 months ago
Thank you Jurien (@French77) for your Dutch translation! All the translations are integrated by a member of the Cinnamon team: Jason Hicks (@jaszhix).
yochananmarqos
yochananmarqos-8 months ago
FYI, ttf-symbola is in the AUR and cannot be installed by pacman. An AUR helper like yay is needed or it can be installed with pamac: yay -S ttf-symbola or pamac build ttf-symbola
claudiux
claudiux-7 months ago
Thank you for the information. Neither yay nor pamac are installed by default in Arch. I will do otherwise by integrating the Symbola-Hinted font into the Spices Update package.
Bundy01
Bundy01-7 months ago
Hi, just one question: why a dependency on a font? I modified the .js to not have the terminal open. Wouldn't it be possible to use the system font? Thank you again for this aplet.
claudiux
claudiux-7 months ago
Hi, The Symbola font contains the \u23FF character (eye), which is displayed in the menu when new Spices are available. https://www.fileformat.info/info/unicode/char/23ff/index.htm
mockturtl
mockturtl-8 months ago
Nice!
MarcoB-0049
MarcoB-0049-8 months ago
EU/D Super praktisch, das Applet! Vielen Dank für die gute Arbeit! UK/Brexit --↓ Super handy, the Applet! Many thanks for the good work!
Bundy01
Bundy01-8 months ago
Very useful applet. Thank you.
claudiux
claudiux-8 months ago
Thank you for all your wonderful messages! This encourages me to continue developing this applet.
SvenRieke
SvenRieke-8 months ago
This functionality should always have been native by Cinnamon. One of the most important applets, a must have.
claudiux
claudiux-8 months ago
German translation is now available. Thanks to @Mintulix!
MrNanook
MrNanook-8 months ago
Great applet, much needed. :-)
Mintulix
Mintulix-8 months ago
This one gets "5 stars" for the well thought out implementation. Great! Missed this since spices have been implemented in the four sections.
claudiux
claudiux-8 months ago
Thanks to @muzena for the Croatian translation!