An open API service indexing awesome lists of open source software.

https://github.com/imjohnbo/alfred-ghlinks

Store, search, and collaborate on web bookmarks, powered by GitHub. 🎩
https://github.com/imjohnbo/alfred-ghlinks

alfred alfred-workflow github links-management

Last synced: 3 months ago
JSON representation

Store, search, and collaborate on web bookmarks, powered by GitHub. 🎩

Awesome Lists containing this project

README

        

# alfred-ghlinks [![GitHub latest release](https://img.shields.io/github/v/release/imjohnbo/alfred-ghlinks)](https://github.com/imjohnbo/alfred-ghlinks/releases) [![NPM latest release](https://img.shields.io/npm/v/alfred-ghlinks)](https://www.npmjs.com/package/alfred-ghlinks) [![MIT license](https://img.shields.io/github/license/imjohnbo/alfred-ghlinks)](https://github.com/imjohnbo/alfred-ghlinks/blob/main/LICENSE)

> Store, search, and collaborate on web bookmarks, powered by GitHub. 🎩

This is an [Alfred](https://www.alfredapp.com/) 🎩 workflow for people who are up to here 🫳 with it with link sprawl already. Store your web bookmarks in a public repo on GitHub – totally normal 🀭 – and share with your besties. Or don't, I'm ok with it. We made private repos just for you.

Then, navigate to your favorite links in like a couple of keystrokes, wow! ⚑️

Requires a paid [Alfred Powerpack](https://www.alfredapp.com/powerpack/).

## Usage
- `ghl alias` – search for a bookmark by alias
- `ghl #tag` – search for a bookmark by tag
- `gho` – open your link file on GitHub
- `gha https://example.com` – start series of prompts to store a new link

https://user-images.githubusercontent.com/2993937/184046331-531d6091-e72c-42ba-8c3c-e36b00876883.mp4

## Installation

`alfred-ghlinks` is easy to install with [npm](https://www.npmjs.com/) and [Node.js 14+](https://nodejs.org/en/).

```
npm i -g alfred-ghlinks
```

Or, head over the [latest releases](https://github.com/imjohnbo/alfred-ghlinks/releases) and getchu a `zip` file.

Next, up open your trusty Alfred workflow editor and "Configure workflow" to type in some required values:
- Name of the JSON file with your links
- Owner and name of the GitHub repository with the JSON file
- GitHub token that can access the GitHub repository

image

## License

[MIT](LICENSE)

## Contributing

Contributions are always welcome! File an issue, start a discussion, or open a pull request.

Psst: https://github.com/imjohnbo/alfred-ghlinks/labels/good%20first%20issue is a good place to start.