Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oae/gnome-shell-pano
Next-gen Clipboard Manager for Gnome Shell
https://github.com/oae/gnome-shell-pano
clipboard-manager gjs gnome gnome-shell-extension rollupjs typescript
Last synced: about 2 months ago
JSON representation
Next-gen Clipboard Manager for Gnome Shell
- Host: GitHub
- URL: https://github.com/oae/gnome-shell-pano
- Owner: oae
- License: gpl-2.0
- Created: 2022-04-04T03:46:40.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-06-27T14:56:13.000Z (3 months ago)
- Last Synced: 2024-06-27T18:14:35.310Z (3 months ago)
- Topics: clipboard-manager, gjs, gnome, gnome-shell-extension, rollupjs, typescript
- Language: TypeScript
- Homepage: https://extensions.gnome.org/extension/5278/pano/
- Size: 3.84 MB
- Stars: 970
- Watchers: 17
- Forks: 51
- Open Issues: 76
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- stars - oae/gnome-shell-pano - gen Clipboard Manager for Gnome Shell (HarmonyOS / Windows Manager)
README
# 
Pano - Next-gen Clipboard Manager
[](#)
[](#)
[](https://github.com/oae/gnome-shell-pano/blob/master/LICENSE)
[](https://github.com/oae/gnome-shell-pano/releases/latest)
[](https://github.com/oae/gnome-shell-pano/compare)
## Features
- ⌨️ Keyboard-driven navigation. See [Navigation](#navigation)
- 🧠 Content aware previews and notifications (Image, Link, Text, Code, Color, Emoji, File). See [Notifications](#content-aware-notifications)
- 🎨 Highly customizable UI with slick design. See [Customization](#settings)
- ⭐ Favorite any items and access them easily. See [Favorites](#favorites)
- ⚙️ And many more options for different needs. See [Settings](#settings)
## Settings
General Options
Customization
Danger Zone
## Favorites
[Favorites](https://user-images.githubusercontent.com/1043714/222934867-d8fb1c2c-81a2-46c6-a8b0-f0be96850d2f.webm)
## Content Aware Notifications
Item Type
Notification
Link
Image
Color
Emoji
Text,Code
File Cut/Copy
## Supported Shell Versions
### Legacy versions
Since Gnome 45 we had to break compatibility with previous Gnome versions, these only receive critical bug / security fixes and are not maintained actively. See [here](https://github.com/oae/gnome-shell-pano/tree/legacy)
- Gnome Shell 42
- Gnome Shell 43
- Gnome Shell 44
### Current version
- Gnome Shell 45
- Gnome Shell 46
## Installation
- You need `libgda` and `gsound` for this extension to work.
- We support both libgda 5.0 and 6.0
- Fedora
```bash
sudo dnf install libgda libgda-sqlite
```
- Arch Linux
```bash
sudo pacman -S libgda6
```
- Ubuntu/Debian
```bash
sudo apt install gir1.2-gda-5.0 gir1.2-gsound-1.0
```
- openSUSE
```bash
sudo zypper install libgda-6_0-sqlite typelib-1_0-Gda-6_0 typelib-1_0-GSound-1_0
```
- You can install the extension from EGO
[
](https://extensions.gnome.org/extension/5278/pano/)
## Usage
### Navigation
[Navigation](https://user-images.githubusercontent.com/1043714/222934876-2e922f6c-36db-456b-826b-3b129da540b4.webm)
- `` `` `v` can be use to toggle visibility of the Pano. This can be changed in Pano extension settings.
- `` `` `` `v` can be use to toggle incognito mode.
- `left` and `right` arrow keys can be used for navigating between items. Pressing `left` key on the first item will focus search box. Also pressing `right` key will go to first/last focused item on the list.
- `up` and `down` keys can also be use to focus on search box and items
- `enter` key or clicking to an item will copy it. You can hold `shift` key for the apps like terminal to paste into it
- Typing anywhere on Pano will focus on search box and filter the results.
- `delete` key will remove the focused item from the list.
- `tab` key will cycle through item types (like `image`, `link` etc..) `shift` `tab` will reverse the direction
- `backspace` key on empty search box will remove item type filter
- `ctrl` `s` key will favorite/unfavorite the item
- `alt` key will switch between favorites/all items
- `ctrl` `1`..`9` keys will copy the item with the corresponding index
- `ctrl` `click` or `ctrl` `enter` shortcuts will copy the links and open them in default browser if `Open Links in Browser` option enabled
## Cli
You can trigger several actions using busctl.
```sh
busctl --user call org.gnome.Shell /io/elhan/Pano io.elhan.Pano clearHistory # clears pano history
busctl --user call org.gnome.Shell /io/elhan/Pano io.elhan.Pano toggle # toggles pano window
busctl --user call org.gnome.Shell /io/elhan/Pano io.elhan.Pano hide # hides pano window
busctl --user call org.gnome.Shell /io/elhan/Pano io.elhan.Pano show # shows pano window
```
## Development
### Build
- This extension is written in Typescript and uses rollup to compile it into javascript.
- To start development, install `nodejs` on your system.
- Clone the project
```sh
git clone https://github.com/oae/gnome-shell-pano.git
cd ./gnome-shell-pano
```
- Install dependencies and build it
```sh
yarn install
yarn build
ln -s "$PWD/dist" "$HOME/.local/share/gnome-shell/extensions/[email protected]"
```
- During development you can use `yarn watch` command to keep generated code up-to-date.