clocket@tirtha: Version 3.0.0 (#1745)

* changelog.md, remove dead code, remove commented-out code

* remove unused settings, prefer const over let, prefer let over var

* renaming, remove dead settings

* renaming

* renaming

* add open-metro

* unit setting

* refactor loadWeatherLayout

* add automatic location setting, renaming settings

* setup translation for GUI

* respect clock-use-24h cinnamon setting

* remove hardcoded weekday and month shorthands, update desklet metadata

* weather description line wrapping

* refactor stylesheet: renaming class names, remove unused classes

* retain weather style when toggling the `show-weather-data` setting

* improve error handling and logging

* setWeatherError function

* weather refresh interval setting

* async data fetching

* caching of Open Metro geodata

* add comments, promise.all, renaming

* font size scaling

* container scaling

* icon scaling

* adjust sizes

* loading text

* settings layout

* date style settings

* border radius settings

* update settings layout

* hide decoration setting

* clock-show-seconds setting, date accent color setting

* show clock setting, show date setting

* hover effect and tooltips for reload buttons

* clock custom time string

* date custom date string

* fix freezing on date and time string changed

* update readme, fix typo

* style presets, fix margins

* update screenshot

* prepare translation files, update german translation

* fix URL in readme.md

* cleanup settings  in `on_desklet_removed()`

* update version order in `CHANGELOG.md`

* remove hard-coded local path

Author: KopfdesDaemons

clocket@tirtha/README.md

@@ -1,43 +1,41 @@
-
-# clocket@tirtha
-
-Clocket is a desklet built for cinnamon DE based on gnome3.
-display time,data and current weather data.<br>
-
-I built this desklet cuz I just wanted a desklet of my own taste.<br>
-Other desklets are great but i wanted a desklet having a clock and <br>
-weather viewer combined.<br>
-
-## installation
-### installation from default desklet downloader (Recommended)
-> rightclick on your desktop
-> select `add desklet`
-> go to "Download" tab, search `clocket` and download that.
-
-### installation from spice 
-> download from <a href="https://cinnamon-spices.linuxmint.com/desklets/view/59">here</a>.
-
-### doenload from source (get the most recent version here)
-> Go <a href="https://github.com/tirtharajsinha/clocket/releases/latest"> here</a> and download the desklet.
-> Then extract the archive and copy the `clocket@tirtha` folder into your `~/.local/share/cinnamon/desklets` folder.
-
-## use
-
-<ol>
-<li>launch the desklet</li>
-<li>right click on desklet select configure..</li>
-<li>change colors of your taste.</li>
-<li>Generate a current weather data api key from <a href="https://openweathermap.org/price">openweathermap.org</a> or existing api .just make sure that api is from openweathermap
-</li>
-<li>now put lat-lon or place name. if you dont know your location get it from <a href="https://tirtharajsinha.github.io/clocket/#latlon">here</a></li>
- <li>To update detailed weather block click on refresh button and in compacted version click current weather icon to refresh weather data.</li>
-</ol>
-
-### important
-
-> notice1 : `in compacted version click current weather icon to refresh weather data.`
-
-
-## For more info visit clocket official <a href="https://tirtharajsinha.github.io/clocket/">site </a> <br>
-
-<img src="screenshot.png" alt ="">
+# clocket@tirtha
+
+Clocket is a desklet built for the Cinnamon DE (based on GNOME 3).
+It displays time, date, and current weather data.
+
+I built this desklet because I just wanted a desklet of my own taste.
+
+Other desklets are great, but I wanted a desklet having a clock and weather viewer combined.
+
+## Installation
+
+### Installation from desklet manager (Recommended)
+
+1. Right-click on your desktop
+2. Select `add desklet`
+3. Go to "Download" tab and search `clocket`
+4. Go to "Manage" tab and add the desklet to the desktop
+
+### Manually installation
+
+1. Download the desklet from [here](https://cinnamon-spices.linuxmint.com/files/desklets/clocket@tirtha.zip)
+2. Extract the archive
+3. Copy the `clocket@tirtha` folder into your `~/.local/share/cinnamon/desklets` folder
+4. You can now add the desklet in the desklet manager.
+
+## Setup weather service
+
+By default, the location is determined based on the IP address and the weather data is loaded from [Open-Meteo](https://open-meteo.com).
+
+### Open Weather
+
+The weather service can be changed to [Open Weather](http://openweathermap.org). An API key is required for this.
+
+### Latitude and longitude format
+
+The string for a latitude and longitude can be generated, for example, at [gps-coordinates.net](https://www.gps-coordinates.net/).
+
+Two string formats are supported. Separated by a comma or a colon:
+
+- 40.741895,-73.989308
+- 40.741895:-73.989308

clocket@tirtha/files/clocket@tirtha/CHANGELOG.md

@@ -0,0 +1,98 @@
+# Changelog
+
+## [3.0.0] 12.02.2026
+
+- added Open-Meteo data service (no API key required)
+- automatic location detection added and set as default
+- show weather on default
+- added setting to switch between Celsius and Fahrenheit
+- added translation for desklet GUI
+- uses the `clock-use-24h` Cinnamon setting
+- uses the `clock-show-seconds` Cinnamon setting
+- added line wrapping for weather description
+- added weather refresh interval setting
+- added desklet scale size setting based on system font size
+- added async data fetching
+- refactoring
+  - dead code removed
+    - unused variables
+    - unused functions
+    - unused settings
+    - removed unused style classes
+  - commented-out code removed
+  - code formatted
+  - prefer `const` over `let`
+  - prefer `let` over `var`
+  - more readable names for properties, variables, functions, etc.
+  - removed tooltips without additional information
+  - renamed settings
+  - removed hardcoded weekday and month shorthands
+  - updated desklet metadata and fix typo in description
+  - removed hardcoded heights and widths in styles
+  - renamed stylesheet class names
+  - error handling and logging
+  - added more code comments
+- added changelog.md
+  - previous changes and version numbers extracted from Git history
+- updated README.md
+- updated screenshot
+- retain weather style when toggling the `show-weather-data` setting
+- caching of Open-Meteo geodata retrieved via city name
+- fix stretched icons
+- added loading text
+- reorganize settings layout
+- added hover effect and tooltips for reload buttons
+- added new settings
+  - date font size
+  - date text color
+  - date accent color
+  - date background color
+  - weather font size
+  - weather forecast background color
+  - clock border radius
+  - date border radius
+  - weather border radius
+  - weather forecast border radius
+  - hide decorations (set to true by default)
+  - show clock setting
+  - show date setting
+  - custom clock time string
+  - custom date time string
+  - style presets
+    - Translucent
+    - Transparent
+    - Material Design
+    - Metro
+    - Mint
+- prepared, updated translation files
+- updated german translation
+
+## [2.5] 16.04.2025
+
+- fix for clock freeze issue
+
+## [no new version number] 03.09.2022
+
+- added support for libsoup3
+
+## [2.4] 20.01.2022
+
+- fixed bugs pointed by users in comment section
+- added compact view
+- added unit converting methods
+- updated Settings panel
+
+## [2.1] 06.08.2021
+
+- added weather forecast display
+
+## [no new version number] 03.07.2021
+
+- auto update feature
+- feedback display
+- more customization
+- removed all unnecessary embedded codes
+
+## [no version number] 13.06.2021
+
+- Initial release