# gmss - gimme my screenshot!

A screenshot utility written in Rust.

## Usage

```shell
gmss -o $HOME/screenshots

gmss -o $HOME/screenshots --filename-format "epic-screenshot_%Y-%m.png"
```

## Why?

I was bored. [Flameshot](https://flameshot.org/) is in my opinion one of the best Linux screenshot utilities. I'm missing a few features, and don't want to bother their developers.

## 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

# Building

Just the binary:

```rust
cargo build --release
```

The binary *and* the man pages:
```shell
./build.sh
```

The binary will be located at `./target/release/gmss` and the man page is located at `./target/release/gmss.1`

# License

- [AGPL 3.0](LICENSE)