{"id":15287825,"url":"https://github.com/tweekmonster/nmux","last_synced_at":"2025-04-28T16:04:10.533Z","repository":{"id":57515242,"uuid":"74332328","full_name":"tweekmonster/nmux","owner":"tweekmonster","description":"A multiplexer for Neovim processes","archived":false,"fork":false,"pushed_at":"2017-03-24T23:43:59.000Z","size":662,"stargazers_count":110,"open_issues_count":1,"forks_count":4,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-28T16:03:29.030Z","etag":null,"topics":["golang","multiplexer","neovim"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tweekmonster.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-21T06:17:50.000Z","updated_at":"2024-08-25T07:04:15.000Z","dependencies_parsed_at":"2022-09-26T18:30:59.891Z","dependency_job_id":null,"html_url":"https://github.com/tweekmonster/nmux","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tweekmonster%2Fnmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tweekmonster%2Fnmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tweekmonster%2Fnmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tweekmonster%2Fnmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tweekmonster","download_url":"https://codeload.github.com/tweekmonster/nmux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251342722,"owners_count":21574244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","multiplexer","neovim"],"created_at":"2024-09-30T15:38:32.949Z","updated_at":"2025-04-28T16:04:10.473Z","avatar_url":"https://github.com/tweekmonster.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=center\u003e\u003cimg alt=\"nmux\" src=\"assets/logo.png\"\u003e\u003c/h1\u003e\n\n`nmux` is a multiplexer for [Neovim][] processes.  It is very much a work in\nprogress at the moment.\n\nIt currently has a built-in HTTP server that renders a single `nvim` process in\nyour browser using websockets as a proof-of-concept.  Short video of `nvim`\nrendered in a browser: https://youtu.be/mzfHBPHkT-E\n\nThe browser client was made mainly for prototyping.  Native GUI clients for\nLinux, macOS, and Windows are being worked on.\n\n## Requirements\n\n[Neovim][] must be installed and `nvim` available in `$PATH`.\n\n\n## Install\n\nThere is an [unstable][] Darwin (macOS) binary available.\nWindows and Linux builds will be available in the future.\n\nYou can also install it with Go:\n\n```\n$ go get -u github.com/tweekmonster/nmux/cmd/nmux\n```\n\n## Usage\n\nTo run the server:\n\n```\n$ nmux --server --addr localhost:9999\n```\n\nTo use Neovim in a browser, go to\n[http://localhost:9999/](http://localhost:9999/)\n\n**Note**: The browser client has been tested and works in Google Chrome.  The\nkeyboard currently doesn't work in Firefox or Safari.  If you're using an\nextension that gives you vi functionality, it will need to be disabled.\n\nIf you're using the Darwin release:\n\n```\n$ nmux.app/Contents/MacOS/nmux --server --addr localhost:9999\n```\n\nThen run `nmux.app` to connect to the server.  If you're using a port other\nthan `9999`, you will need to run the client the same way, but without the\n`--server` flag.  A future release will allow you to configure a remote server\nand optionally spawn a local server.\n\n\n## Goals\n\n- A server that manages multiple `nvim` processes.\n  - Allow clients to connect over TCP.\n  - Shared unnamed register between all `nvim` processes.\n- Native cross-platform client programs.\n  - Each `nvim` instance can be a tab or a split view.\n  - UI is always consistent.  No platform-specific GUI elements, except for the\n    title bar.\n  - Image replacements for glyphs (in-editor icons).\n  - Basic OS integration (clipboard, notifications, open URLs, etc.)\n- \"Simplified\" configuration.\n  - Only basics need to be configured for client programs.\n    - Client programs can be scripted and configured via vimscript.\n  - No need to configure a terminal emulator or tmux.  `nvim` can already be\n    configured and scripted to no end.\n\nThe ultimate goal is to create native client apps that connect to the `nmux`\nserver, making the terminal emulator an obsolete program in my daily work.\nThis is not an attempt to create a new terminal emulator—`nvim` already has\nreliable terminal emulator built-in through [libvterm][].\n\nThis will make it possible to turn a Docker container or Virtual Machine\n(possibly even WSL) into your \"IDE\".  You could take a snapshot of your\nworkspaces and resume where you left off after a reboot.\n\n\n[Neovim]: https://github.com/neovim/neovim\n[unstable]: https://github.com/tweekmonster/nmux/releases/tag/unstable\n[libvterm]: https://github.com/neovim/libvterm\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftweekmonster%2Fnmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftweekmonster%2Fnmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftweekmonster%2Fnmux/lists"}