Skip to content

Commit 20200b8

Browse files
committed
Add commands
1 parent 51bb83c commit 20200b8

3 files changed

Lines changed: 168 additions & 0 deletions

File tree

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# TAGLINE
2+
3+
Print media type of file
4+
5+
# TLDR
6+
7+
**Determine the media type** of a file
8+
9+
```gst-typefind-1.0 [path/to/file]```
10+
11+
**Detect media types** of multiple files
12+
13+
```gst-typefind-1.0 [path/to/file1] [path/to/file2]```
14+
15+
**Use a custom plugin path** for type detection
16+
17+
```gst-typefind-1.0 --gst-plugin-path=[path/to/plugins] [path/to/file]```
18+
19+
# SYNOPSIS
20+
21+
**gst-typefind-1.0** [_options_] _files_
22+
23+
# PARAMETERS
24+
25+
**--gst-plugin-path=**_PATH_
26+
> Add colon-separated directories to the GStreamer plugin search path.
27+
28+
**--gst-plugin-spew**
29+
> Enable error output during plugin loading.
30+
31+
**--gst-info-mask=**_FLAGS_
32+
> Set GStreamer info flags.
33+
34+
**--gst-debug-mask=**_FLAGS_
35+
> Set GStreamer debugging flags.
36+
37+
**--gst-mask=**_FLAGS_
38+
> Set both GStreamer info and debugging flags simultaneously.
39+
40+
**--help**
41+
> Display help information.
42+
43+
# DESCRIPTION
44+
45+
**gst-typefind-1.0** is a command-line tool from the GStreamer multimedia framework that identifies the media type (MIME type) of files. It uses GStreamer's typefind subsystem, which examines file headers and content patterns through installed plugins to determine what kind of media a file contains.
46+
47+
The tool applies a probability-based detection system where plugins report confidence levels for their media type matches. It is specifically designed for multimedia files that GStreamer can handle, rather than being a general-purpose file type detector.
48+
49+
# CAVEATS
50+
51+
Detection accuracy depends entirely on which GStreamer plugins are installed. If the plugin for a particular media format is missing, the file may not be identified correctly or at all. This tool is not a replacement for the general-purpose **file** command, as it only recognizes media types supported by the installed GStreamer plugin ecosystem.
52+
53+
# HISTORY
54+
55+
**gst-typefind-1.0** is part of the **GStreamer** multimedia framework, originally created for the GNOME project. The **1.0** suffix was introduced with the GStreamer 1.0 release in **September 2012**, allowing parallel installation with the older 0.10 series. The typefind subsystem is a core part of GStreamer's architecture, enabling automatic media format detection across the framework.
56+
57+
# SEE ALSO
58+
59+
[gst-inspect-1.0](/man/gst-inspect-1.0)(1), [gst-launch-1.0](/man/gst-launch-1.0)(1), [file](/man/file)(1)

assets/commands/index.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2942,6 +2942,7 @@ gst-discoverer-1.0.md
29422942
gst-inspect-1.0.md
29432943
gst-launch-1.0.md
29442944
gst-play-1.0.md
2945+
gst-typefind-1.0.md
29452946
gsutil.md
29462947
gt.md
29472948
gtf.md
@@ -7466,6 +7467,7 @@ tsv-filter.md
74667467
tsx.md
74677468
tt.md
74687469
tts.md
7470+
tty-clock.md
74697471
tty.md
74707472
ttyd.md
74717473
ttyper.md

assets/commands/tty-clock.md

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
# TAGLINE
2+
3+
Terminal digital clock
4+
5+
# TLDR
6+
7+
**Display a centered clock** with seconds
8+
9+
```tty-clock -c -s```
10+
11+
**Display in 12-hour format** with bold font
12+
13+
```tty-clock -t -b```
14+
15+
**Display with a box border** in green
16+
17+
```tty-clock -x -C 2```
18+
19+
**Display UTC time** with a custom date format
20+
21+
```tty-clock -u -f "[%A %d %B]"```
22+
23+
**Display in screensaver mode** (exits on keypress)
24+
25+
```tty-clock -S -c -s```
26+
27+
**Display with bouncing motion** and blinking colon
28+
29+
```tty-clock -r -B```
30+
31+
# SYNOPSIS
32+
33+
**tty-clock** [**-iuvsScbtrahDBxn**] [**-C** _0-7_] [**-f** _format_] [**-d** _delay_] [**-a** _nsdelay_] [**-T** _tty_]
34+
35+
# PARAMETERS
36+
37+
**-s**
38+
> Display seconds.
39+
40+
**-S**
41+
> Screensaver mode; exit on first keypress.
42+
43+
**-x**
44+
> Show a box around the clock.
45+
46+
**-c**
47+
> Center the clock on the terminal.
48+
49+
**-C** _0-7_
50+
> Set clock color (0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white).
51+
52+
**-b**
53+
> Enable bold font.
54+
55+
**-t**
56+
> Use 12-hour (AM/PM) time format.
57+
58+
**-u**
59+
> Display UTC time.
60+
61+
**-T** _tty_
62+
> Display clock on the specified terminal device.
63+
64+
**-r**
65+
> Enable bouncing motion; clock bounces off terminal edges.
66+
67+
**-f** _format_
68+
> Custom date format string (per **strftime**(3)).
69+
70+
**-n**
71+
> Do not quit on keypress; must be killed with a signal.
72+
73+
**-D**
74+
> Hide the date display.
75+
76+
**-B**
77+
> Enable blinking colon separator.
78+
79+
**-d** _delay_
80+
> Set redraw delay in seconds (default: 1).
81+
82+
**-a** _nsdelay_
83+
> Additional nanosecond delay between redraws.
84+
85+
**-v**
86+
> Display version information.
87+
88+
**-h**
89+
> Display help text.
90+
91+
# DESCRIPTION
92+
93+
**tty-clock** is a terminal-based digital clock built with the ncurses library. It renders the current time in large block digits directly in the terminal, with optional date display below. The clock supports various display modes including centering, bouncing animation, screensaver mode, and customizable colors.
94+
95+
While running, the clock responds to keyboard commands: **K/J/H/L** for vi-style repositioning, **0-7** to change color, **B** to toggle bold, **X** to toggle the box border, **C** to center, **R** for bouncing mode, **S** to toggle seconds, **T** for 12-hour format, and **Q** to quit.
96+
97+
# CAVEATS
98+
99+
The **-C** color option only supports the basic 8-color terminal palette. Centering with **-c** disables vi-style movement commands. When using **-n** mode, the process must be terminated with a signal since keypress exit is disabled. Requires **libncurses** to be installed.
100+
101+
# HISTORY
102+
103+
**tty-clock** was created by **Martin Duquesnoy** (xorg62) in **2008** as a lightweight terminal clock utility written in C. The project has been community-maintained since, with contributions improving signal handling, locale compatibility, and ncurses support over the years.
104+
105+
# SEE ALSO
106+
107+
[tty](/man/tty)(1), [date](/man/date)(1), [watch](/man/watch)(1)

0 commit comments

Comments
 (0)