mirror of
https://github.com/jiriks74/presence.nvim
synced 2024-12-29 03:12:04 +01:00
95 lines
6.2 KiB
Markdown
95 lines
6.2 KiB
Markdown
<img src="https://gist.githubusercontent.com/andweeb/df3216345530234289b87cf5080c2c60/raw/8de399cfed82c137f793e9f580027b5246bc4379/presence.nvim.png" alt="presence.nvim">​
|
|
|
|
**[Features](#features)** | **[Installation](#installation)** | **[Configuration](#configuration)** | **[Troubleshooting](#troubleshooting)** | **[Development](#development)** | **[Contributing](#contributing)**
|
|
|
|
> Discord [Rich Presence](https://discord.com/rich-presence) plugin for [Neovim](https://neovim.io)
|
|
|
|
<img src="https://gist.githubusercontent.com/andweeb/df3216345530234289b87cf5080c2c60/raw/4b07351547ae9a6bfdcbc1f915889b90a5349242/presence-demo.gif" alt="demo.gif">
|
|
|
|
## Features
|
|
* Simple and unobtrusive
|
|
* Support for macOS, Linux, and Windows[\*](#notes)
|
|
* No Python/Node providers (or CoC) required
|
|
* Startup time is fast(er than other Rich Presence plugins, by [kind of a lot](https://github.com/andweeb/presence.nvim/wiki/Plugin-Comparisons))
|
|
* Written in Lua and configurable in Lua (but also configurable in VimL if you want)
|
|
|
|
## Installation
|
|
Use your favorite plugin manager
|
|
* [vim-plug](https://github.com/junegunn/vim-plug): `Plug 'andweeb/presence.nvim'`
|
|
* [packer.nvim](https://github.com/wbthomason/packer.nvim): `use 'andweeb/presence.nvim'`
|
|
|
|
#### Notes
|
|
* Requires [Neovim nightly](https://github.com/neovim/neovim/releases/tag/nightly) (0.5)
|
|
* Windows is [partially supported](https://github.com/andweeb/presence.nvim/projects/1#card-60537963), WSL is [not yet supported](https://github.com/andweeb/presence.nvim/projects/1#card-60537961)
|
|
|
|
## Configuration
|
|
Rich Presence works right out of the box after installation, so configuration is **optional**! For those that do want to override default behaviors, however, configuration options are available in either Lua or VimL.
|
|
|
|
### Lua
|
|
Require the plugin and call `setup` with a config table with any of the following keys:
|
|
|
|
```lua
|
|
-- The setup config table shows all available config options with their default values:
|
|
require("presence"):setup({
|
|
-- General options
|
|
auto_update = true, -- Update activity based on autocmd events (if `false`, map or manually execute `:lua package.loaded.presence:update()`)
|
|
neovim_image_text = "The One True Text Editor", -- Text displayed when hovered over the Neovim image
|
|
main_image = "neovim", -- Main image display (either "neovim" or "file")
|
|
client_id = "793271441293967371", -- Use your own Discord application client id (not recommended)
|
|
log_level = nil, -- Log messages at or above this level (one of the following: "debug", "info", "warn", "error")
|
|
debounce_timeout = 10, -- Number of seconds to debounce events (or calls to `:lua package.loaded.presence:update(<filename>, true)`)
|
|
enable_line_number = false, -- Displays the current line number instead of the current project
|
|
|
|
-- Rich Presence text options
|
|
editing_text = "Editing %s", -- Format string rendered when an editable file is loaded in the buffer
|
|
file_explorer_text = "Browsing %s", -- Format string rendered when browsing a file explorer
|
|
git_commit_text = "Committing changes", -- Format string rendered when commiting changes in git
|
|
plugin_manager_text = "Managing plugins", -- Format string rendered when managing plugins
|
|
reading_text = "Reading %s", -- Format string rendered when a read-only or unmodifiable file is loaded in the buffer
|
|
workspace_text = "Working on %s", -- Workspace format string (either string or function(git_project_name: string|nil, buffer: string): string)
|
|
line_number_text = "Line %s out of %s", -- Line number format string (for when enable_line_number is set to true)
|
|
})
|
|
```
|
|
|
|
### VimL
|
|
Or if global variables are more your thing, you can use any of the following instead:
|
|
```viml
|
|
" General options
|
|
let g:presence_auto_update = 1
|
|
let g:presence_neovim_image_text = "The One True Text Editor"
|
|
let g:presence_main_image = "neovim"
|
|
let g:presence_client_id = "793271441293967371"
|
|
let g:presence_log_level
|
|
let g:presence_debounce_timeout = 10
|
|
let g:presence_enable_line_number = 0
|
|
|
|
" Rich Presence text options
|
|
let g:presence_editing_text = "Editing %s"
|
|
let g:presence_file_explorer_text = "Browsing %s"
|
|
let g:presence_git_commit_text = "Committing changes"
|
|
let g:presence_plugin_manager_text = "Managing plugins"
|
|
let g:presence_reading_text = "Reading %s"
|
|
let g:presence_workspace_text = "Working on %s"
|
|
let g:presence_line_number_text = "Line %s out of %s"
|
|
```
|
|
|
|
## Troubleshooting
|
|
* Ensure that Discord is running
|
|
* Ensure that your Neovim version is on 0.5
|
|
* Ensure Game Activity is enabled in your Discord settings
|
|
* Enable logging and inspect the logs after opening a buffer
|
|
* Set the [`log_level`](#lua) setup option or [`g:presence_log_level`](#viml) to `"debug"`
|
|
* Load a file and inspect the logs with `:messages`
|
|
* If there is a `Failed to get Discord IPC socket` error, your particular OS may not yet be supported
|
|
* If you don't see an existing [issue](https://github.com/andweeb/presence.nvim/issues) or [card](https://github.com/andweeb/presence.nvim/projects/1#column-14183588) for your OS, create a prefixed [issue](https://github.com/andweeb/presence.nvim/issues/new) (e.g. `[Void Linux]`)
|
|
|
|
## Development
|
|
* Clone the repo: `git clone https://github.com/andweeb/presence.nvim.git`
|
|
* Enable [logging](#configuration) and ensure that `presence.nvim` is **_not_** in the list of vim plugins in your config
|
|
* Run `nvim` with your local changes: `nvim --cmd 'set rtp+=path/to/your/local/presence.nvim' file.txt`
|
|
* Ensure that there are no [luacheck](https://github.com/mpeterv/luacheck/) errors: `luacheck lua`
|
|
|
|
## Contributing
|
|
Pull requests are very welcome, feel free to open an issue to work on any of the open [todo items](https://github.com/andweeb/presence.nvim/projects/1?add_cards_query=is%3Aopen)!
|
|
|
|
Asset additions and changes are also welcome! Supported file types can be found in [`file_assets.lua`](lua/presence/file_assets.lua) and their referenced asset files can be found [in this folder](https://www.dropbox.com/sh/j8913f0gav3toeh/AADxjn0NuTprGFtv3Il1Pqz-a?dl=0).
|