HTML countdown server

A simple HTML countdown generator as an HTTP server.

Getting started

Requirements

• NodeJS

Installation

• npm install html-countdown-server -g

Usage

HTTP server

• html-countdown-server

Eventually followed by a port number (default is 8080), eg. : html-countdown-server 1234

HTTP client

Minimal URL :

• http://localhost:PORT/?time=HH

The time parameter must follow one of the following formats :

• HH
• HH:MM
• HH:MM:SS

An invalid or undefined time parameter will return a 400 (Bad Request) HTTP error.

Optional parameters :

| Parameter | Default value | Description | Type | | ----------------- | ------------- | -------------------| ---------------------------------------------------------------------------------- | | textColor | #4C5193 | Text color | CSS color (string) | | backgroundColor | #00000000 | Background color | CSS color (string) | | fontFamily | Poppins | Font family | Google Fonts font (string) | | fontWeight | 700 | Font weight | Positive integer (usually light = 300, normal = 400, bold = 700, etc.) | | fontSize | 77px | Font size | CSS length | | endText | LIVE | Countdown end text | String |

Examples :

• http://localhost:8080/?time=12
• http://localhost:8080/?time=12:13
• http://localhost:8080/?time=12:13:14
• http://localhost:8080/?time=12:13:14&textColor=#FFF&backgroundColor=#000
• http://localhost:8080/?time=12:13:14&textColor=white&backgroundColor=black&fontFamily=Roboto&fontWeight=400&fontSize=50px&endText=The end

Yes, CSS color values supports # wich are automatically replaced by %23 and string values supports spaces which are automatically replaced with %20.

Embedding compatibility

This tool has been successfully tested in <iframe>, in OBS Studio as browser source and should work in Streamlabs OBS and Electron.

Changelog

• 1.0.0 (2020-08-31) • Initial release
• 1.0.1 (2020-09-01)
  • Change default backgroundColor to #00000000
  • Fix potential path issue
• 1.0.2 (2020-09-02) • Fix number 10 being transformed to 010