Skip to content

An unofficial DevDocs API Documentation viewer for macOS.

License

Notifications You must be signed in to change notification settings

dteoh/devdocs-macos

Repository files navigation

DevDocs for macOS

Release Release Date

An unofficial DevDocs API Documentation viewer for macOS.

App screenshot

Features

  • Tabs
  • Global shortcut (Option+Space)
  • Automatic dark/light mode UI
  • Protocol handler integration (handle devdocs-macos://, http://, and https:// URLs)

Protocol handler integration

Protocol handler integration allows you to control DevDocs through scripts. For example:

$ osascript -e 'tell application "DevDocs" to open location "devdocs-macos://search?doc=rails&term=stro"'

... will tell DevDocs to open a new window and search the Rails documentation for the term stro.

The app supports the following commands. When required parameters are not supplied, the command is ignored.

devdocs-macos://search

This is for launching a search query in a new window.

Query Parameter Required Description
term Yes The search term, eg. stro
doc No Documentation scope, eg. rails

devdocs-macos://newWindow

This opens a new window.

http:// and https://

DevDocs will open a new window only for URLs on the devdocs.io domain. For example:

$ osascript -e 'tell application "DevDocs" to open location "https://devdocs.io/#q=rails+stro"'

Other domains are ignored.

Download & Install

Pre-built binaries can be downloaded from the releases page.

Unzip, drag the app to Applications, and then run it.

Homebrew

If you wish to install the application from Homebrew:

$ brew tap dteoh/devdocs
$ brew cask install devdocs-macos

The application will live at /Applications/DevDocs.app.

Compatibility

The app is currently developed on Mojave and only support for Mojave can be provided.

License

DevDocs for macOS

Copyright (C) 2019 Douglas Teoh

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

App Icon

The app icon is a contribution courtesy of @micck (#1).