Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 13 additions & 17 deletions TimeAndDate@nightflame/README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,25 @@

Time and Date Cinnamon Desklet v0.1 - 19 June 2013
# Time and Date Desklet

This is a simple desklet to display the time and date. The size and format of the date are configurable by changing the values in metadata.json. This can be launched from the Desklet itself by selecting Config from the menu.
This is a simple customizable desklet to display the time and date. The format of the time and date are configurable through desklet settings.

Adjust the following paramters in the metadata.json file which is stored in ~/.local/share/cinnamon/desklets/TimeAndDate@nightflame:
### Customization

"timeFormat": "%H:%M",
"timeSize": "50pt",
"dateFormat": "%A,%e %B",
"dateSize": "25pt"
You can customize this desklet to your taste. Change yours fonts, colors, sizes and more. Check out the different options.

** REMEMBER TO LEAVE THE COMMAS IN - except for the last line!**
### How to configure it:

The time and date format are from JavaScript toLocaleFormat function, and the possible values can be found at:
The time and date format are from the JavaScript `toLocaleFormat` function, and the possible values can be found at:

http://pubs.opengroup.org/onlinepubs/007908799/xsh/strftime.html

For exmple to add seconds change timeFormat to:
For example to change time format to HOURS:MINUTES:SECONDS use `%H:%M:%S`. Also, you may use any normal characters between special formatting characters like `%H text %M`, which would render as ex. `14 text 50` at 14:50.

"timeFormat": "%H:%M:%S",
** After changing the settings you need to remove and re-add the Desklet **
### Tips
- You can add multiple desklets by clicking the "+" icons in your desklet manager.
- You can backup your desklets by going to the settings. There you should find an icon in the top right corner. Select the Export to a file option or import to load your backup.

If I knew what I was doing I would update the config through the GUI. Maybe next version.

-Steve
desklets [at] stargw [dot] eu
### Remarks

This desklet was originally made by @nightflame. At the time of writing, this desklet had not been updated for years. I decided to heavily modernize it, because it was lacking in functionality compared with newer desklets.
25 changes: 25 additions & 0 deletions TimeAndDate@nightflame/files/TimeAndDate@nightflame/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@

## [2.0] - 05.11.2025

Overhaul/modernization of 8+ years old code.

### Added

- Many new utility and visual settings
- `CHANGELOG.md`
- `settings-schema.json`


### Changed

- General code refactoring
- Completely changed desklet customization, now its using xlet-settings instead of proprietary `metadata.json` and `stylesheet.css` customization.
- Reworked UI rendering
- New screenshot
- `README.md`
- `TimeAndDate@nightflame.pot`


### Removed

- All previous translation, they are no longer relevant.
29 changes: 0 additions & 29 deletions TimeAndDate@nightflame/files/TimeAndDate@nightflame/README

This file was deleted.

Loading