diff options
| author | sinanmohd <pcmsinan@gmail.com> | 2022-07-08 18:41:28 +0530 |
|---|---|---|
| committer | sinanmohd <pcmsinan@gmail.com> | 2022-07-08 18:41:28 +0530 |
| commit | 499432b4d86cbb9bc4f3e518bed2b98168a4bb80 (patch) | |
| tree | f795cea36f03217dc8535c2a1fa7f5d1b752d5e4 /README.md | |
initial commit
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..d086498 --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ + + +stikman is a cross platform sticker solution for the desktop using sxiv and dmenu. tested on element and telegram, should also work on other platforms + + +## Showcase + + +## Notes + +apply [this](https://gitlab.com/sinanmohd/stikman/-/blob/master/nout-sxiv.patch) patch to sxiv or use the patched version [here](https:/gitlab.com/sinanmohd/nsxiv) for a more seamless experience, it'll automatically quit sxiv after sticker selection + +## Usage + +* launch stikman using a key binding daemon like [sxhkd](https://wiki.archlinux.org/title/Sxhkd) and select a sticker using `m`. additionally quit using `q` if you didint apply the [nout sxiv patch](https://gitlab.com/sinanmohd/stikman/-/blob/master/nout-sxiv.patch) + +``` +stikman install <pack.zip> install sticker pack +stikman rm remove sticker pack +stikman view view sticker pack +stikman add <image file> add a new item to sticker pack +stikman share get a shareable link for sticker pack +stikman rename rename a sticker pack +stikman fetch <link> install pack from a link +stikman create <directory> make pack from images inside the directory +stikman help print this menu +``` + +## Dependencies + +* [`sxiv`](https://codeberg.org/nsxiv/nsxiv) +* [`dmenu`](https://tools.suckless.org/dmenu/) +* [`imagemagick`](https://imagemagick.org/index.php) +* [`xclip`](https://github.com/astrand/xclip) +* [`xdotool`](https://github.com/jordansissel/xdotool) + +## Optional dependencies + +* [`curl`](https://github.com/curl/curl) (for sharing and downloading sticker packs) +* [`zip`](http://www.info-zip.org/Zip.html) (for sharing sticker packs) +* [`unzip`](http://infozip.sourceforge.net/UnZip.html) (for installing sticker packs) + +## FAQ + +* how do i import telegram stickers ? + +send telegram sticker link to any sticker downloader bot (eg: [@downloader_sticker_bot](https://t.me/downloader_sticker_bot), [@DownloadStickersBot](https://t.me/DownloadStickersBot)), download the zip file and install them using `stikman install file.zip` |