Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/deanishe/alfred-reddit

Browse Reddit from Alfred
https://github.com/deanishe/alfred-reddit

alfred alfred-workflow python reddit workflow

Last synced: about 1 month ago
JSON representation

Browse Reddit from Alfred

Awesome Lists containing this project

README

        

Reddit for Alfred
=================

Find subreddits and browse hot posts on [Reddit][reddit].

![][demo]

Download
--------

Get Reddit for Alfred from [GitHub][gh-releases].

**Note**: Version 1.4 (and above) is *not* compatible with Alfred 2. Please download [v1.3][v13] if you're using Alfred 2.

Usage
-----

- `r/` — Show list of popular subreddits
- `⇥`, `↩` or `⌘+NUM` — Show 50 hottest posts in selected subreddit
- `⌘+↩` — Open subreddit in browser
- `⇧` or `⌘+Y` — Show Quick Look preview of subreddit
- `⌥+↩` - Make post in the subreddit
- `r/` — Search for subreddits matching ``
- `⇥` — Show 50 hottest posts in selected subreddit (same as appending `/`)
- `↩` or `⌘+NUM` — Open subreddit in browser
- `⇧` or `⌘+Y` — Show Quick Look preview of subreddit
- `⌥+↩` - Make post in the subreddit
- `r//[]` — Show 50 hottest posts on subreddit ``, filtered by `` if present
- `↩` or `⌘+NUM` — Open article in default browser
- `⌘+↩` — Open Reddit comments in default browser
- `⌥+↩` — Open article and Reddit comments in default browser
- `⌘+L` — Show full post title in Alfred's Large Type window
- `⇧` or `⌘+Y` — Show Quick Look preview of comments page (or post)
- `r/u//m//[]` — Show 50 hottest posts on user multireddit.

**Note:** OS X's "delete word" shortcut (`⌥+⌫`) is very handy for backing out of a subreddit.

Description
-----------

A basic workflow to browse subreddits.

The subreddit search, `r/`, uses Reddit's API to search for subreddits that match ``. 25 results are retrieved by default.

The subreddit search can be a bit odd, which is due to the legendary crapness of Reddit's search function.

Search within a subreddit, `r/subreddit/`, only filters the list of hot results. 50 results are retrieved by default.

Configuration
-------------

There are a couple of options in the workflow's [configuration sheet][config-sheet].

Set `NSFW` to `1` to include subreddits marked "over 18" in search results.

Set `QUICKLOOK_POST` to `1` for the Quick Look preview to show the article instead of the Reddit comment page.

Licensing, thanks etc.
----------------------

Alfred-Reddit is released under the [MIT Licence][mit].

I found the logo in a [Font Awesome issue][logo-source] on GitHub.

It's heavily based on [Alfred-Workflow][alfred-workflow], also [MIT-licensed][mit].

[reddit]: http://www.reddit.com
[mit]: http://opensource.org/licenses/MIT
[alfred-workflow]: http://www.deanishe.net/alfred-workflow/
[logo-source]: https://github.com/FortAwesome/Font-Awesome/issues/372
[gh-releases]: https://github.com/deanishe/alfred-reddit/releases
[demo]: https://raw.githubusercontent.com/deanishe/alfred-reddit/master/demo.gif
[v13]: https://github.com/deanishe/alfred-reddit/releases/tag/v1.3
[config-sheet]: https://www.alfredapp.com/help/workflows/advanced/variables/#environment