Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hoothin/rustclock

A digital clock for desktop popup every half hour written in rust, support 20-20-20 rule. 每隔半小時彈出一次的桌面電子時鐘 Windows / Mac
https://github.com/hoothin/rustclock

20-20-20-rule analog-clock clock digital-clock egui macos rust windows

Last synced: 9 days ago
JSON representation

A digital clock for desktop popup every half hour written in rust, support 20-20-20 rule. 每隔半小時彈出一次的桌面電子時鐘 Windows / Mac

Host: GitHub
URL: https://github.com/hoothin/rustclock
Owner: hoothin
License: mit
Created: 2023-05-25T04:04:52.000Z (over 1 year ago)
Default Branch: master
Last Pushed: 2023-10-21T07:49:06.000Z (about 1 year ago)
Last Synced: 2024-10-16T21:09:03.883Z (23 days ago)
Topics: 20-20-20-rule, analog-clock, clock, digital-clock, egui, macos, rust, windows
Language: Rust
Homepage:
Size: 1.73 MB
Stars: 330
Watchers: 3
Forks: 13
Open Issues: 8
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # Rust Clock 

[![license](https://img.shields.io/badge/license-MIT-red.svg)](https://github.com/hoothin/RustClock/releases/tag/0.1.5) [![download](https://img.shields.io/github/downloads/hoothin/RustClock/total)](https://github.com/hoothin/RustClock/releases/tag/0.1.5)

[**📧Mail Me**](mailto:[email protected])

Clock popup every half hour. Build with [rust](https://github.com/rust-lang/rust)|[egui](https://github.com/emilk/egui/)|[rodio](https://github.com/RustAudio/rodio)|[tray-icon](https://github.com/tauri-apps/tray-icon)|[chrono](https://github.com/chronotope/chrono)|[rust-ini](https://github.com/zonyitoo/rust-ini)

![example](pic.gif)

# Install

+ [Release](https://github.com/hoothin/RustClock/releases/tag/0.1.5)

+ Homebrew

``` bash

brew install hoothin/rust_clock/rust_clock

```

# Config

Edit the conf.ini beside rust_clock, delete `#`.

> 編輯可執行文件旁的 conf.ini，去除对应项前的注释符号`#`。

## TOC

1. [time 時刻](#time)

2. [sound 音效](#sound)

3. [countdown 倒計時](#countdown)

4. [pos 位置](#pos)

5. [color 顔色](#color)

6. [show_time 駐留時間](#show_time)

7. [tips 提示文字](#tips)

8. [font_path 提示字體](#font_path)

9. [bg 背景圖](#bg)

10. [init_show 啓動時顯示](#init_show)

11. [timezone 時區](#timezone)

12. [time_font 時間數字字體](#time_font)

13. [round 圓角](#round)

14. [time_countdown 定點倒計時](#time_countdown)

---

+ time



> The time when rust clock will popup, set by `hour:minute:second`. Split multi-time by `,`.

> 

> 設置 rust clock 彈出的時刻，使用 `時:分:秒` 的格式，多個時刻使用 `,` 分隔。彈出時無視倒計時。

``` ini

# popup every half hour per clock

# 每個鐘頭的 30 分鐘彈出

time=:30:

```

``` ini

# popup every half hour and every beginning of minute in 15 o'clock

# 每個鐘頭的 30 分鐘與 15 點整彈出

time=:30:,15::0

```

+ sound



> The sound file you wish to play when clock popup.

>

> 彈出時播放的音效文件

``` ini

# play sound.ogg when popup

# 彈出時播放同目錄下的 sound.ogg 文件

sound=sound.ogg

```

``` ini

# play assets/1.mp3 when reaches first time you set，play assets/2.mp3 when reaches second time you set.

# 設定的第一個報時播放 assets/1.mp3，設定的第二個報時播放 assets/2.mp3

sound=assets/1.mp3|assets/2.mp3

```

``` ini

# Increase the countdown sound effect on the above basis, play assets/3.mp3 when reaches first countdown you set，play assets/4.mp3 when reaches second countdown you set.

# 在上面的基礎上區分倒計時音效，第一個倒計時播放 assets/3.mp3，第二個倒計時播放 assets/4.mp3

sound=assets/1.mp3|assets/2.mp3*assets/3.mp3|assets/4.mp3

```

+ countdown



> The countdown time, set by `hour:minute:second`. Split multi-time by `,`.

>

> 倒計時，使用 `時:分:秒` 的格式，多個倒計時使用 `,` 分隔。默認為 10 分鐘，開啓後會循環啓動。

``` ini

# 20-20-20 Rule 護眼法則

countdown=:20:,::20

```

+ pos



> The position where will rust clock popup.

>

> rust clock 的彈出位置。

``` ini

# popup from right side of screen, 20% top of screen height.

# 在屏幕右側彈出，彈出位置距離屏幕頂部 20% 高度

pos=right,20%

```

+ color



> The color of rust clock. Format by r,g,b or r,g,b,a

>

> rust clock 各個位置的顔色。格式為 r,g,b 或者 r,g,b,a

``` ini

# Color of background.

# 背景顏色

bg_color=207,210,206,200

# Color of border.

# 邊框顏色

border_color=91,105,114

# Color of number background.

# 數字背景顏色

number_bg_color=235,235,235

# Color of number.

# 數字顏色

number_color=0,0,0

# Color of clock circle background.

# 鐘面背景顏色

clock_bg_color=235,235,235

```

+ show_time



> The time that how long the popup will last. Set in milliseconds

>

> 彈出后持續顯示時長，按毫秒計算

``` ini

# Continuous display for 1000 milliseconds after pop-up

# 彈出后持續顯示 1000 毫秒

show_time=1000

```

+ tips



> Text displayed when pop-up, format as same as `sound`

>

> 彈出后顯示的文字，格式同 `sound`，可設置多個

``` ini

# display 'by the grave and thee' when pop-up

# 彈出時顯示 'by the grave and thee'

tips=by the grave and thee

```

+ font_path



> The font path which is used by tips

>

> 彈出文字使用的字體路徑

``` ini

# use font which is located in 'C:/Windows/Fonts/zongyi.TTF'

# 使用位於 'C:/Windows/Fonts/zongyi.TTF' 的字體

font_path=C:/Windows/Fonts/zongyi.TTF

```

+ bg



> The path of background image, 80\*80 for clock, 320\*100 for total background

>

> 背景圖片的路徑，尺寸為 80\*80 時設置為鐘面背景，尺寸為 320\*100 時設置為整體背景

``` ini

bg=assets/bg.png

```

+ init_show



> Show clock after initialization, 0 means disable, 1 means enable

>

> 啓動后立即顯示，0 為禁用顯示，1 為啓用

``` ini

init_show=0

```

+ timezone



> Timezone of clock, from -12 to +12

>

> 時區，從 -12（西12區） 到 +12（東12區）

``` ini

timezone=+9

```

+ time_font



> The font path which is used by time number

>

> 時刻數字使用的字體路徑

``` ini

time_font=C:/Windows/Fonts/zongyi.TTF

```

+ round



> Round the corners of frame, 0 means no

>

> 是否使用圓角邊框，0 為 否

``` ini

round=0

```

+ time_countdown



> Show countdown until reach first full-set `time`, the difference from `countdown` is that this item displays a countdown to a fixed time point, rather than a cyclic countdown from the startup time, 1 means enable

>

> 顯示直到`time`中第一個時分秒都完整設置時間的倒計時，1 為啓用，與`countdown`的區別為此項顯示到固定時間點的倒計時，而非自啓動時間起的循環倒計時

``` ini

time_countdown=1

```