% GMSS(1) version 0.1.0 | User Commands
%
% 22 December 2023

NAME
====

gmss - gimme my screenshot!

SYNOPSIS
========

| **gmss** **\--out** _location_

DESCRIPTION
===========

A screenshot utility. Nothing else.

OPTIONS
=======

**-o** _location_, **\--out** _location_

:   The output directory or file path to write to.

    If a directory is specified, a filename will be generated based on the current date and time.
    (Required)

    Example:

    :   **\--out** _$HOME/screenshots/my_screenshot.png_

        **\--out** _/$HOME/screenshots_

FILENAME TIMESTAMPS
===================

gmss has support for formatting timestamps in filenames.

The default filename format is
```
screenshot-%Y-%m-%d_%H-%M-%S.png
```

- `%Y`: Year with century as a decimal number (e.g., 2022)
- `%m`: Month as a zero-padded decimal number (01 to 12)
- `%B`: Full month name (e.g., January)
- `%b`: Abbreviated month name (e.g., Jan)
- `%d`: Day of the month as a zero-padded decimal number (01 to 31)
- `%e`: Day of the month as a decimal number (1 to 31)
- `%A`: Full weekday name (e.g., Monday)
- `%a`: Abbreviated weekday name (e.g., Mon)
- `%H`: Hour (00 to 23)
- `%I`: Hour (01 to 12)
- `%M`: Minute (00 to 59)
- `%S`: Second (00 to 59)
- `%p`: AM or PM designation
- `%f`: Subsecond (in nanoseconds)
- `%F`: ISO 8601 date format (YYYY-MM-DD)
- `%c`: Date and time representation appropriate for locale
- `%r`: 12-hour clock time (e.g., 08:30:45 PM)
- `%Z`: Time zone offset (+0900)
- `%z`: Time zone offset (+09:00)
- `%U`: Week number of the year (Sunday as the first day of the week) (00 to 53)
- `%W`: Week number of the year (Monday as the first day of the week) (00 to 53)
- `%j`: Day of the year (001 to 366)
- `%x`: Date representation for the current locale
- `%X`: Time representation for the current locale
- `%%`: Percent sign

BUGS
====

Bugs can be submitted via e-mail.

AUTHORS
=======

holly sparkles \<sparkles@holly.sh>

REPOSITORY
==========

https://git.holly.sh/gmss.git