https://github.com/tuberry/color-picker

Simple color picker for GNOME Shell.
https://github.com/tuberry/color-picker

Last synced: about 2 months ago
JSON representation

Simple color picker for GNOME Shell.

• Host: GitHub
• URL: https://github.com/tuberry/color-picker
• Owner: tuberry
• License: gpl-3.0
• Created: 2020-08-03T05:57:58.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-09-08T22:21:14.000Z (3 months ago)
• Last Synced: 2024-09-08T23:30:16.616Z (3 months ago)
• Language: JavaScript
• Homepage:
• Size: 320 KB
• Stars: 135
• Watchers: 2
• Forks: 11
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• stars - tuberry/color-picker

README

        
# color-picker

Simple color picker for GNOME Shell.

> 春水碧于天，画船听雨眠。 —— *韦庄《菩萨蛮》*


[![license]](/LICENSE.md)

![color-picker-menu](https://user-images.githubusercontent.com/17917040/229520114-8e023786-fe8a-47bc-952e-263b8bf20b69.png)

## Installation

### Manual

The latest and supported version should only work on the most current stable version of GNOME Shell.

```bash

git clone --recurse-submodules https://github.com/tuberry/color-picker.git && cd color-picker

meson setup build && meson install -C build

# meson setup build -Dtarget=system && meson install -C build # system-wide, default --prefix=/usr/local

```

For older versions (< 44), it's recommended to install via:

### E.G.O

[][EGO]

## Features

![cppref](https://user-images.githubusercontent.com/17917040/155882315-739d0ec7-9947-49a8-a58c-31475feafdc6.png)

### DBus

The DBus interface returns the same result as XDG Desktop [Screenshot] Portal required:

```bash

gdbus call --session --dest org.gnome.Shell --object-path /org/gnome/Shell/Extensions/ColorPicker --method org.gnome.Shell.Extensions.ColorPicker.Pick

```

## Contributions

Any contribution is welcome.

### Ideas

For any question or idea, feel free to open an issue or PR in the repo.

### Translations

To update the po file from sources:

```bash

bash ./cli/update-po.sh [your_lang_code] # like zh_CN, default to $LANG

```

### Developments

To install GJS TypeScript type [definitions](https://www.npmjs.com/package/@girs/gnome-shell):

```bash

npm install @girs/gnome-shell --save-dev

```

## Acknowledgements

* [PowerToys]: the idea of custom color formats

[license]:https://img.shields.io/badge/license-GPLv3+-green.svg

[EGO]:https://extensions.gnome.org/extension/3396/color-picker/

[Screenshot]:https://github.com/flatpak/xdg-desktop-portal/blob/main/data/org.freedesktop.portal.Screenshot.xml

[PowerToys]:https://learn.microsoft.com/en-us/windows/powertoys/color-picker#managing-color-formats