Permalink
Newer
100644
162 lines (90 sloc)
4.96 KB
|
|
||
| 1 | # Caprine <img src="static/Icon.png" width="60"> | |
|
|
||
| 2 | ||
|
|
||
| 3 | > Elegant Facebook Messenger desktop app | |
| 4 | ||
| 5 | Caprine is an unofficial and privacy focused Facebook Messenger app with many useful features. | |
|
|
||
| 6 | ||
|
|
||
| 7 | **[Website](https://sindresorhus.com/caprine)** **[Discuss it on Product Hunt](https://www.producthunt.com/posts/caprine-2)** | |
|
|
||
| 8 | ||
|
|
||
| 9 | <br> | |
|
|
||
| 10 | ||
| 11 | <a href="https://github.com/sindresorhus/caprine/releases/latest"> | |
| 12 | <img src="media/screenshot.png" width="846"> | |
| 13 | </a> | |
|
|
||
| 14 | ||
| 15 | ||
|
|
||
| 16 | ## Highlights | |
| 17 | ||
| 18 | - [Dark theme](#dark-mode) | |
| 19 | - [Vibrant theme](#vibrancy)* | |
| 20 | - [Privacy focused](#hide-last-seen--typing-indicator) | |
| 21 | - [Keyboard shortcuts](#keyboard-shortcuts) | |
| 22 | - Cross-platform | |
| 23 | - Silent auto-updates | |
| 24 | - Custom text size | |
| 25 | ||
| 26 | \*macOS only | |
| 27 | ||
|
|
||
| 28 | ## Install | |
| 29 | ||
|
|
||
| 30 | *macOS 10.9+, Linux, and Windows 7+ are supported (64-bit only).* | |
|
|
||
| 31 | ||
|
|
||
| 32 | Download the latest version on the [website](https://sindresorhus.com/caprine) or below. | |
| 33 | ||
|
|
||
| 34 | ### macOS | |
| 35 | ||
| 36 | [**Download**](https://github.com/sindresorhus/caprine/releases/latest) the `.dmg` file. | |
| 37 | ||
|
|
||
| 38 | Or with [Homebrew-Cask](https://caskroom.github.io): `$ brew cask install caprine` | |
|
|
||
| 39 | ||
| 40 | ### Linux | |
| 41 | ||
| 42 | [**Download**](https://github.com/sindresorhus/caprine/releases/latest) the `.AppImage` or `.deb` file. | |
| 43 | ||
|
|
||
| 44 | *The AppImage needs to be [made executable](http://discourse.appimage.org/t/how-to-make-an-appimage-executable/80) after download.* | |
| 45 | ||
|
|
||
| 46 | ### Windows | |
| 47 | ||
| 48 | [**Download**](https://github.com/sindresorhus/caprine/releases/latest) the `.exe` file. | |
| 49 | ||
|
|
||
| 50 | *For taskbar notification badges to work on Windows 10, you'll need to [enable it in Taskbar Settings](https://www.tenforums.com/tutorials/48186-taskbar-buttons-hide-show-badges-windows-10-a.html).* | |
|
|
||
| 51 | ||
|
|
||
| 52 | ||
|
|
||
| 53 | ## Features | |
|
|
||
| 54 | ||
| 55 | ### Dark mode | |
| 56 | ||
|
|
||
| 57 | You can toggle dark mode in the `View` menu or with <kbd>Cmd</kbd> <kbd>D</kbd> / <kbd>Ctrl</kbd> <kbd>D</kbd>. | |
|
|
||
| 58 | ||
|
|
||
| 59 | <img src="media/screenshot-dark.png" width="846"> | |
|
|
||
| 60 | ||
|
|
||
| 61 | ### Vibrancy | |
| 62 | ||
|
|
||
| 63 | On *macOS*, you can toggle the window vibrancy effect in the `View` menu. | |
|
|
||
| 64 | ||
| 65 | <img src="media/screenshot-vibrancy.jpg" width="1165"> | |
|
|
||
| 66 | ||
|
|
||
| 67 | ### Hide last seen / typing indicator | |
| 68 | ||
| 69 | <img src="media/screenshot-block-typing-indicator.png" width="626"> | |
| 70 | ||
| 71 | You can choose to prevent people from knowing when you've seen a message or are currently typing. Both options are available under the `Caprine`/`File` menu. | |
| 72 | ||
|
|
||
| 73 | ### Jump to conversation hotkey | |
| 74 | ||
|
|
||
| 75 | You can switch conversations similar to how you switch browser tabs: <kbd>Cmd/Ctrl</kbd> <kbd>n</kbd> (where `n` is `1` through `9`). | |
|
|
||
| 76 | ||
|
|
||
| 77 | ### Compact mode | |
| 78 | ||
| 79 | The interface adapts when resized to a small size. | |
| 80 | ||
| 81 | <div align="center"><img src="media/screenshot-compact.png" width="512"></div> | |
| 82 | ||
| 83 | ### Desktop notifications | |
| 84 | ||
| 85 | Desktop notifications can be turned on in Preferences. | |
| 86 | ||
| 87 | <div align="center"><img src="media/screenshot-notification.png" width="358"></div> | |
| 88 | ||
|
|
||
| 89 | ### Always on Top | |
| 90 | ||
| 91 | You can toggle whether Caprine stays on top of other windows in the `Window`/`View` menu or with <kbd>Cmd/Ctrl</kbd> <kbd>Shift</kbd> <kbd>t</kbd>. | |
| 92 | ||
|
|
||
| 93 | ### Image paste confirmation | |
|
|
||
| 94 | ||
|
|
||
| 95 | Confirmation before sending images from the clipboard, to prevent accidental copy-pastes. | |
|
|
||
| 96 | ||
|
|
||
| 97 | ### Background behavior | |
|
|
||
| 98 | ||
|
|
||
| 99 | When closing the window, the app will continue running in the background, in the dock on macOS and the tray on Linux/Windows. Right-click the dock/tray icon and choose `Quit` to completely quit the app. On macOS, click the dock icon to show the window. On Linux, right-click the tray icon and choose `Toggle` to toggle the window. On Windows, click the tray icon to toggle the window. | |
|
|
||
| 100 | ||
|
|
||
| 101 | If you like to have Caprine minimized on startup, open it from the command-line with the `--minimize` flag. | |
|
|
||
| 102 | ||
|
|
||
| 103 | ### Keyboard shortcuts | |
| 104 | ||
|
|
||
| 105 | Description | Keys | |
| 106 | -----------------------| ----------------------- | |
| 107 | New conversation | <kbd>Cmd/Ctrl</kbd> <kbd>n</kbd> | |
| 108 | Search conversations | <kbd>Cmd/Ctrl</kbd> <kbd>f</kbd> | |
| 109 | Toggle "Dark mode" | <kbd>Cmd/Ctrl</kbd> <kbd>d</kbd> | |
| 110 | Next conversation | <kbd>Cmd/Ctrl</kbd> <kbd>]</kbd> or <kbd>Ctrl</kbd> <kbd>Tab</kbd> | |
| 111 | Previous conversation | <kbd>Cmd/Ctrl</kbd> <kbd>[</kbd> or <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>Tab</kbd> | |
| 112 | Jump to conversation | <kbd>Cmd/Ctrl</kbd> <kbd>1</kbd>โฆ<kbd>9</kbd> | |
| 113 | Mute conversation | <kbd>Cmd/Ctrl</kbd> <kbd>Shift</kbd> <kbd>m</kbd> | |
| 114 | Archive conversation | <kbd>Cmd/Ctrl</kbd> <kbd>Shift</kbd> <kbd>a</kbd> | |
| 115 | Delete conversation | <kbd>Cmd/Ctrl</kbd> <kbd>Shift</kbd> <kbd>d</kbd> | |
| 116 | Toggle "Always on Top" | <kbd>Cmd/Ctrl</kbd> <kbd>Shift</kbd> <kbd>t</kbd> | |
|
|
||
| 117 | Toggle window menu | <kbd>Alt</kbd> *(Windows only)* | |
|
|
||
| 118 | ||
|
|
||
| 119 | ||
| 120 | --- | |
|
|
||
| 121 | ||
| 122 | ||
| 123 | ## Dev | |
| 124 | ||
| 125 | Built with [Electron](http://electron.atom.io). | |
| 126 | ||
|
|
||
| 127 | ### Run | |
|
|
||
| 128 | ||
|
|
||
| 129 | ``` | |
| 130 | $ npm install && npm start | |
| 131 | ``` | |
|
|
||
| 132 | ||
|
|
||
| 133 | ### Build | |
|
|
||
| 134 | ||
|
|
||
| 135 | See the [`electron-builder` docs](https://github.com/electron-userland/electron-builder/wiki/Multi-Platform-Build). | |
|
|
||
| 136 | ||
|
|
||
| 137 | ### Publish | |
| 138 | ||
| 139 | Use [`np`](https://github.com/sindresorhus/np) and for example run: | |
| 140 | ||
| 141 | ``` | |
| 142 | $ np minor --no-publish | |
| 143 | ``` | |
| 144 | ||
| 145 | Then edit the automatically created GitHub Releases draft, remove the `.pkg` file, and publish. | |
| 146 | ||
|
|
||
| 147 | ||
|
|
||
| 148 | ## Maintainers | |
| 149 | ||
| 150 | - [Sindre Sorhus](https://sindresorhus.com) | |
| 151 | - [Aw Young Qingzhuo](https://github.com/veniversum) | |
| 152 | ||
| 153 | ||
|
|
||
| 154 | ## Disclaimer | |
| 155 | ||
| 156 | Caprine is a third-party app and is not affiliated with Facebook. | |
| 157 | ||
| 158 | ||
|
|
||
| 159 | ## License | |
| 160 | ||
|
|
||
| 161 | MIT |