https://github.com/ivanfon/tekaim
A simple tool to take and upload screenshots to teknik.io (can be configured for other hosts)
https://github.com/ivanfon/tekaim
Last synced: 11 months ago
JSON representation
A simple tool to take and upload screenshots to teknik.io (can be configured for other hosts)
- Host: GitHub
- URL: https://github.com/ivanfon/tekaim
- Owner: IvanFon
- License: gpl-3.0
- Created: 2018-03-13T23:51:28.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-06-09T02:57:30.000Z (about 7 years ago)
- Last Synced: 2025-08-31T03:42:27.146Z (11 months ago)
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tekaim
A simple tool to take and upload screenshots to teknik.io
## Installation
### Arch Linux
tekaim is available on the AUR. You can either install it with `makepkg` or your preferred AUR helper:
```
yay -S tekaim
pikaur -S tekaim
trizen -S tekaim
etc
```
### Other Linux Distro's
tekaim depends on Python 3+, `maim`, `curl`, and `xclip`. Ensure you have these installed beforehand. At this time, tekaim only supports Linux.
Go to the [latest release](https://github.com/IvanFon/tekaim/releases/latest) and download `tekaim-X.Y.Z.tar.gz`, then use the following commands to untar and install it:
```
tar -xf tekaim-X.Y.Z.tar.gx
cd tekaim
python setup.py install
```
The final command may require `sudo` permissions to install.
## Usage
Run `tekaim` and make a selection. After a few seconds, the URL to your uploaded image will appear. By default, tekaim will upload to [teknik.io](https://www.teknik.io/). The URL will also be copied to your clipboard.
Screenshots are saved to `~/.tekaim/screenshots/` and image links and deletion links are saved to `~/.tekaim/history/`.
### Arguments
- '-f': take screenshot of entire desktop
- '-d': developer mode
- load config from same directory as executable
- print debug info
### Configuration
By default, tekaim's config file is stored in `~/.config/tekaim/config.json`. The config file supports single-line, C-style comments. The default config file has a comment explaining each option.
If the config file is missing, tekaim should automatically download the default file from this repository. If you need the default config for whatever reason, it can be found [here](https://github.com/IvanFon/tekaim/blob/master/config.json).
## Dependencies
By default, tekaim depends on [maim](https://github.com/naelstrof/maim) for screenshots, [curl](https://github.com/curl/curl) for uploading, and [xclip](https://github.com/astrand/xclip) to copy to your clipboard. If you want to use something different, you can configure commands and arguments in `config.json`.