Skip to content

Commit

Permalink
Initial release (v1.0.0)
Browse files Browse the repository at this point in the history
  • Loading branch information
reallySmooll committed Jun 12, 2023
1 parent cbeac62 commit 47ababe
Show file tree
Hide file tree
Showing 4 changed files with 76 additions and 0 deletions.
76 changes: 76 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,77 @@
# scolorpicker
scolorpicker is a color picker application written in C using nothing but Xlib.

This is why scolorpicker can be installed anywhere an X.Org server is installed, is very lightweight with the executable clocking in at just 18k and has very little
dependencies (which you probably don't have to install if you use X11).

## Installation
There are three ways of installing scolorpicker:

- Using an AUR wrapper (e.g. `yay` or `paru`) **RECOMMENDED**

Using `yay`:
```bash
$ yay -S scolorpicker
```

Using `paru`:
```bash
$ paru -S scolorpicker
```

- Using the executable from [Releases](https://www.github.com/reallySmooll/scolorpicker/releases)

First, go to the latest release of scolorpicker (in this case it's `v1.0.0`):

![releases](assets/releases.png)

Next, go download the `scolorpicker` executable:

![releases_download](assets/releases_download.png)

After you download it, you can use it by executing it in the command line:
```bash
$ directory/to/where/you/downloaded/scolorpicker
```

If you'd like to have it in you `PATH` and use it without moving into the directory where you have the executable you can move (or copy) it to `/usr/bin` for example:
```bash
$ sudo mv directory/to/where/you/downloaded/scolorpicker /usr/bin
# or copy it
$ sudo cp directory/to/where/you/downloaded/scolorpicker /usr/bin
```

And then wherever you are, you can do:
```bash
$ scolorpicker
```

- Building if from source

First, clone the repository and cd into the directory:
```bash
$ git clone https://github.com/reallySmooll/scolorpicker.git
$ cd scolorpicker/
```

Next, build and install scolorpicker:
```bash
$ sudo make install
```

And that's it! `make` will build the application automatically and copy the executable into the `/usr/bin/` directory so you can use it like any other command without having to cd into the directory and running it from there!

## Usage
Usage is pretty straight-forward, you start the application and click on the pixel you want to get the color of and it will be copied to your clipboard.

Which means that if everything works out, there should scolorpicker should output nothing to the terminal.

## Features
Here's a list of features already implemented and ones I would like to implement in the (near?) future:

- [X] Small window displaying the color of the current pixel (v1.0.0)
- [X] Color code in hexadecimal (v1.0.0)
- [X] Color output to clipboard (v1.0.0)
- [ ] Color code output in different modes (RGB, HSV, etc.)
- [ ] Ability to choose to output the color code to the terminal instead of the clipboard
- [ ] System tray so you don't have to enter a command in the terminal to get the color of a pixel (which, I'll admit is pretty dumb)
Binary file added assets/output.mkv
Binary file not shown.
Binary file added assets/releases.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/releases_download.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 47ababe

Please sign in to comment.