stable v1.1.0 - new features: HTTP call + YAML presets & defaults

- Add --url flag to fire HTTP GET on timer finish with response display
- Add ~/.dstimer/defaults.yaml for global default settings
- Add ~/.dstimer/presets.yaml for named timer configurations (e.g. dstimer pomodoro)
- Positional arg now accepts preset names or time values
- TUI skips audio/URL prompts when values are prefilled from config
- Update README with configuration docs, TOC, and new install methods

Author: madLinux7

.github/workflows/release.yml

@@ -37,7 +37,7 @@ jobs:
 
           - target: x86_64-pc-windows-msvc
             runner: windows-latest
-            asset_name: dstimer-windows-x86_64.exe
+            asset_name: dstimer.exe
 
     steps:
       - uses: actions/checkout@v4
@@ -114,7 +114,7 @@ jobs:
   #       uses: vedantmgoyal9/winget-releaser@v2
   #       with:
   #         identifier: madLinux.dstimer
-  #         installers-regex: 'dstimer-windows-x86_64\.exe$'
+  #         installers-regex: 'dstimer\.exe$'
   #         token: ${{ secrets.WINGET_TOKEN }}
 
   update-scoop:
@@ -131,16 +131,16 @@ jobs:
       - name: Download Windows artifact
         uses: actions/download-artifact@v4
         with:
-          name: dstimer-windows-x86_64.exe
+          name: dstimer.exe
           path: artifacts
 
       - name: Update Scoop manifest
         run: |
           VERSION="${GITHUB_REF_NAME#v}"
-          SHA256=$(sha256sum artifacts/dstimer-windows-x86_64.exe | cut -d' ' -f1)
+          SHA256=$(sha256sum artifacts/dstimer.exe | cut -d' ' -f1)
           jq --arg v "$VERSION" --arg h "$SHA256" \
             '.version = $v |
-             .architecture."64bit".url = "https://github.com/madLinux7/dead-simple-cli-timer/releases/download/v\($v)/dstimer-windows-x86_64.exe#/dstimer.exe" |
+             .architecture."64bit".url = "https://github.com/madLinux7/dstimer/releases/download/v\($v)/dstimer.exe" |
              .architecture."64bit".hash = $h' \
             bucket/dstimer.json > bucket/dstimer.json.tmp && mv bucket/dstimer.json.tmp bucket/dstimer.json
 

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "dstimer"
-version = "1.0.5"
+version = "1.1.0"
 edition = "2021"
 description = "A dead-simple, cross-platform CLI countdown timer with color-changing progress bar and optional audio playback"
 license = "MIT"
@@ -21,6 +21,9 @@ rodio = { version = "0.17", default-features = false, features = [
 ] }
 ctrlc = "3.4"
 ureq = "2"
+serde = { version = "1", features = ["derive"] }
+serde_yaml = "0.9"
+dirs = "5"
 [target.'cfg(not(target_os = "macos"))'.dependencies]
 notify-rust = "4"
 

Cargo.toml

@@ -4,11 +4,42 @@
 ![License](https://img.shields.io/badge/license-MIT-blue)
 ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
 
-A dead-simple, cross-platform CLI countdown timer with color-changing progress bar and optional audio playback on finish.
+A dead-simple, cross-platform CLI countdown timer featuring:
+
+- Color-changing progress bar
+- Fullscreen / Inline mode
+- Optional audio playback
+- Optional HTTP webhook
+- Optional notifications on finish
+- YAML-based presets and defaults.
 
 Written in Rust for maximum efficiency and portability.
 
-![Demo with 7 as argument representing the seconds](demo_args_1.gif)
+<p align="center">
+  <img src="demo_args_1.gif" alt="dssh demo"><br>
+  <sub>Demo with 7 seconds as argument (Fullscreen)</sub>
+</p>
+
+<p align="center">
+  <img src="demo_pomodoro_yaml.gif" alt="dssh demo"><br>
+  <sub>Demo with pomodoro preset (Inline)</sub>
+</p>
+
+## Table of Contents
+
+- [Features](#features)
+- [Usage](#usage)
+  - [TUI / Interactive mode](#tui--interactive-mode-no-arguments)
+  - [Fullscreen mode](#fullscreen-mode)
+  - [Inline mode](#inline-mode---inline---i)
+- [Configuration](#configuration)
+  - [defaults.yaml](#defaultsyaml--global-defaults)
+  - [presets.yaml](#presetsyaml--named-presets)
+- [Install](#install)
+- [Supported Audio Formats](#supported-audio-formats)
+- [Build from Source](#build-from-source)
+- [Contributing](#contributing)
+- [Acknowledgements](#-acknowledgements-)
 
 ## Features
 
@@ -17,23 +48,29 @@ Written in Rust for maximum efficiency and portability.
 - Full-width **progress bar**: green → yellow → red as time runs out
 - Interactive **time entry** (HH:MM:SS) when no arguments parsed
 - ♪ Optional **audio file playback** when the timer completes ♪
+- Optional **HTTP call** (`--url`) — fires a GET request on finish and shows the response
+- **YAML presets** — save named presets (e.g. `dstimer pomodoro`) in `~/.dstimer/presets.yaml`
+- **Global defaults** — set default audio, URL, inline/silent in `~/.dstimer/defaults.yaml`
 
 ## Usage
 
 | Flag | Short | Description |
 |------|-------|-------------|
-| `--time` | `-t` | Default argument parsing duration in `HH:MM:SS`, `MM:SS`, or `SS` format |
+| `--time` | `-t` | Duration in `HH:MM:SS`, `MM:SS`, or `SS` format |
 | `--audio` | `-a` | Path to audio file to play on finish |
+| `--url` | `-u` | URL to call (HTTP GET) when timer finishes |
 | `--inline` | `-i` | Inline mode (see below) |
 | `--silent` | | Suppress desktop notifications |
 
-### **Interactive mode** (no arguments):
+The positional argument can be a **time value** (`dstimer 25:00`) or a **preset name** (`dstimer pomodoro`). See [Configuration](#configuration) below.
+
+### **TUI / Interactive mode** (no arguments):
 
 ```bash
 dstimer
 ```
 
-You'll be prompted to enter a duration and an optional audio file path.
+You'll be prompted to enter a duration, an optional audio file path, and an optional URL.
 
 ![demo_manual](demo_manual.gif)
 
@@ -45,6 +82,9 @@ dstimer 25:00 # 25 minutes
 dstimer 7 # 7 seconds
 dstimer --time 1:30:17 # 1 hour 30 minutes 17 seconds
 dstimer 90 --audio /path/to/audio.wav # plays audio.wav after 90 seconds
+dstimer 5:00 --url https://example.com/hook # fires HTTP GET after 5 minutes
+dstimer pomodoro # loads named preset
+dstimer pomodoro -t 30:00 # preset with CLI time override
 ```
 
 ![Demo with seconds and audio as arguments](demo_args_2.gif)
@@ -62,23 +102,85 @@ Renders the timer on the **current terminal line** instead of taking over the fu
 ![Demo inline with -i -t 00:00:07 args](demo_inline_args_1.gif)
 ![Demo inline with -i -t 00:00:07 -a "home/linuxg/Musik/Super Survivor.flac" args](demo_inline_args_2.gif)
 
-## Install
+## Configuration
+
+dstimer automatically creates `~/.dstimer/` with two YAML files on first run.
+
+### `defaults.yaml` — Global defaults
+
+These values apply to every run unless overridden by a preset or CLI flags.
+
+```yaml
+inline: false
+silent: false
+audio: ""
+url: ""
+```
 
-**macOS / Linux:**
+When `audio` or `url` are set here, the interactive TUI **skips those prompts** automatically.
+
+### `presets.yaml` — Named presets
+
+Define reusable timer presets and call them by name:
+
+```yaml
+pomodoro:
+  time: "25:00"
+  inline: true
+  silent: false
+  audio: "/home/user/music/bell.flac"
+  url: "https://example.com/pomodoro-done"
+
+break:
+  time: "5:00"
+  silent: true
+```
+
+Then just run:
 
 ```bash
+dstimer pomodoro           # uses all preset values, starts immediately
+dstimer break              # 5-minute silent break timer
+dstimer pomodoro -t 30:00  # override just the time
+```
+
+All fields in a preset entry are optional. Missing fields fall back to `defaults.yaml`.
+
+**Priority order:** CLI flags > preset > defaults.yaml
+
+## Install
+
+### Linux / macOS Install Script
+
+```sh
 curl -fsSL https://raw.githubusercontent.com/madLinux7/dstimer/main/install.sh | sh
 ```
 
-**Windows (PowerShell):**
+### macOS
 
-```powershell
+**homebrew**
+
+```sh
+brew install madLinux7/tap/dstimer 
+```
+
+### Windows
+
+**Winget:**
+
+```ps1
+winget install madLinux.dstimer
+```
+
+**PowerShell Install Script:**
+
+```ps1
 irm https://raw.githubusercontent.com/madLinux7/dstimer/main/install.ps1 | iex
 ```
 
-**Via Cargo (requires Rust):**
+### Via Cargo (requires Rust)
 
-```bash
+```sh
 cargo install dstimer
 ```
 
@@ -115,6 +217,8 @@ dstimer couldn't be dead simple without the efforts of some great open-source pr
 - [crossterm](https://github.com/crossterm-rs/crossterm) — cross-platform terminal manipulation
 - [rodio](https://github.com/RustAudio/rodio) — audio playback
 - [Symphonia](https://github.com/pdeljanov/Symphonia) — audio decoding (MP3, FLAC, WAV, OGG, ...)
+- [ureq](https://github.com/algesten/ureq) — lightweight HTTP client
+- [serde](https://github.com/serde-rs/serde) + [serde_yaml](https://github.com/dtolnay/serde-yaml) — YAML configuration
 - [ctrlc](https://github.com/Detegr/rust-ctrlc) — Ctrl+C signal handling
 - [notify-rust](https://github.com/hoodie/notify-rust) — desktop notifications on Linux & Windows
 - [winresource](https://github.com/mxre/winresource) — embedding the app icon on Windows