https://github.com/0x61nas/lqth

Simple but blazingly fast screenshot utility
https://github.com/0x61nas/lqth

screenshot screenshot-utility x11 xscreenshot

Last synced: 3 months ago
JSON representation

Simple but blazingly fast screenshot utility

• Host: GitHub
• URL: https://github.com/0x61nas/lqth
• Owner: 0x61nas
• License: mit
• Created: 2023-12-11T21:50:20.000Z (about 1 year ago)
• Default Branch: aurora
• Last Pushed: 2024-10-09T13:20:01.000Z (3 months ago)
• Last Synced: 2024-10-10T18:47:31.148Z (3 months ago)
• Topics: screenshot, screenshot-utility, x11, xscreenshot
• Language: Rust
• Homepage: https://lib.rs/crates/lqth
• Size: 1.42 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


    



**Lqth (لقطه) which means "shot" or/and "capture" in Arabic** is a simple but blazingly fast screenshot utility

inspired by [xscreenshot](https://git.codemadness.org/xscreenshot) and follows the suckless philosophy...(AHM, ahmmmm)... most of it :).

[![crates.io](https://img.shields.io/crates/v/lqth.svg)](https://crates.io/crates/lqth)

[![docs.rs](https://docs.rs/lqth/badge.svg)](https://docs.rs/lqth)

[![downloads](https://img.shields.io/crates/d/lqth.svg)](https://crates.io/crates/lqth)

[![license](https://img.shields.io/crates/l/lqth.svg)](https://github.com/0x61nas/lqth/blob/aurora/LICENSE)

[![FlakeHub](https://img.shields.io/endpoint?url=https://flakehub.com/f/0x61nas/lqth/badge)](https://flakehub.com/flake/0x61nas/lqth)

## Examples

The boring way:

```rust

use lqth::*;

let tick = TickTick {

   dpy_addr: DpyAddr::Current,

   win: Window::Root(0),

   mode: Mode::Full,

};

let mut buf = Vec::new();

tick.tick(&mut buf).unwrap();

```

Just take a screenshot for the full screen!

```rust

use lqth::LqthConfig;

let mut out = std::io::stdout().lock();

// ok!

().tick(&mut out).unwrap();

```

## The  binary?

> Nah, am a norme person and I don't wanna write code in this language to JUST TAKE A SCREENSHOT, can you give me a JW solution?

We offer a simple binary that's implement the most of this crate features. You can build it with the build command or if u use cargo then you can install it via `cargo install lqth`.

> [!Note]

> for more information about the binary and how to use it, you can run `lqth -h` or see this [document](./docs/bin.md).

## Wayland?

Nah, I luv my X.

## Contributing

I'm happy to accept any contributions, just consider reading the [CONTRIBUTING.md](https://github.com/0x61nas/lqth/blob/aurora/CONTRIBUTING.md) guide first. to avoid waste waste our time on some unnecessary things.

> the main keywords are: **signed commits**, **conventional commits**, **no emojis**, **linear history**, **the PR shouldn't have more than tree commits most of the time**

## License

This project is licensed under [MIT license][mit].

[mit]: https://github.com/0x61nas/lqth/blob/aurora/LICENSE

# Usage as a flake

Add lqth to your `flake.nix`:

```nix

{

  inputs.lqth.url = "https://flakehub.com/f/0x61nas/lqth/*.tar.gz";

  outputs = { self, lqth }: {

    # Use in your outputs

  };

}

```

## Dependencies graph

![deps graph](./_deps.png)

> Generated with [cargo-depgraph](https://crates.io/crates/cargo-depgraph)

Current version: 0.2.2