{"id":45315897,"url":"https://github.com/ifrederico/sublime-liveserverplus","last_synced_at":"2026-05-09T06:03:03.653Z","repository":{"id":275251551,"uuid":"925045988","full_name":"ifrederico/sublime-liveserverplus","owner":"ifrederico","description":"A development server with live reload capabilities.","archived":false,"fork":false,"pushed_at":"2026-05-09T04:57:14.000Z","size":14471,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-09T05:27:41.272Z","etag":null,"topics":["development","live-reload","live-server","markdown","sublime-text"],"latest_commit_sha":null,"homepage":"https://github.com/ifrederico/sublime-liveserverplus","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ifrederico.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-31T05:46:21.000Z","updated_at":"2026-05-09T04:57:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"1ba6252e-b4af-459c-bf03-7f32ef3c9334","html_url":"https://github.com/ifrederico/sublime-liveserverplus","commit_stats":null,"previous_names":["ifrederico/sublime-liveserverplus"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/ifrederico/sublime-liveserverplus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifrederico%2Fsublime-liveserverplus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifrederico%2Fsublime-liveserverplus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifrederico%2Fsublime-liveserverplus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifrederico%2Fsublime-liveserverplus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ifrederico","download_url":"https://codeload.github.com/ifrederico/sublime-liveserverplus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifrederico%2Fsublime-liveserverplus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32809147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["development","live-reload","live-server","markdown","sublime-text"],"created_at":"2026-02-21T07:51:07.432Z","updated_at":"2026-05-09T06:03:03.639Z","avatar_url":"https://github.com/ifrederico.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Live Server Plus for Sublime Text\n\nA lightweight development server with WebSocket‑based live reload.\n\n![Live Server Plus Demo](./images/liveserverplus1.gif)\n\n---\n\n## Installation\n\n### Package Control (recommended)\n\n1. Open the Command Palette: **`Cmd/Ctrl + Shift + P`**  \n2. Select **Package Control: Install Package**  \n3. Search for **“LiveServerPlus”** and install.\n\n### Manual\n\n1. Download or clone this repository.  \n2. In Sublime Text, choose **Preferences ▸ Browse Packages…**  \n3. Copy the folder into the `Packages` directory and name it **`LiveServerPlus`**.\n\n---\n\n## Usage\n\nOpen a file, folder or workspace (**File ▸ Open Folder**) first.\n\n### Main menu\n\n*Tools ▸ Live Server Plus*:\n\n| Action | Description |\n| ------ | ----------- |\n| **Start Server** | Starts the server (multi‑folder picker). |\n| **Stop Server** | Stops the server. |\n| **Open in Browser** | Opens the active file through the server. |\n| **Show Mobile QR Code** | Displays a QR linking devices on the LAN to the dev URL. |\n| **Enable Live Reload** | Switch to Sublime-driven reload (auto-save option). |\n| **Disable Live Reload** | Return to Watchdog-based external file watching. |\n| **Change Port…** | Enter any port or **0** for “find a free one”. |\n| **Enable Debug Logging** | Print LiveServerPlus diagnostics to the Sublime console. |\n| **Settings…** | Opens the user settings file. |\n\n### Command Palette\n\n`Cmd/Ctrl + Shift + P` → type:\n\n- **Live Server Plus: Start Server**  \n- **Live Server Plus: Stop Server**  \n- **Live Server Plus: Open in Browser**  \n- **Live Server Plus: Show Mobile QR Code**  \n- **Live Server Plus: Enable Live Reload**  \n- **Live Server Plus: Disable Live Reload**  \n- **Live Server Plus: Change Port…**  \n- **Live Server Plus: Enable Debug Logging**\n- **Live Server Plus: Disable Debug Logging**\n- **Live Server Plus: Settings**\n\n### Example workflow\n\n1. Open your project folder.  \n2. Run **Live Server Plus: Start Server**.  \n3. Edit and save—your browser refreshes automatically.\n\n---\n\n## Features\n\n- **Instant reload** on file changes; optional CSS-only injection. Enable Sublime-only mode when you want immediate reloads on save, or leave it disabled to monitor external tools via Watchdog.  \n- **GitHub-style Markdown preview** with live scroll sync—defaults to editor→browser, switch to \"sync\" for two-way or `false` to disable.  \n- **Mobile preview**: scan a QR code to open the site on any device.  \n- **Port selection**: choose a port at startup or set `\"port\": 0` for a free one.  \n- **Automatic watcher fallback**: native watchers for performance, seamless polling fallback when macOS hits the file-descriptor limit.  \n- **Runs in Sublime’s bundled Python**—no external runtime required.\n\n---\n\n## Optional key bindings\n\n```json\n[\n    { \"keys\": [\"alt+shift+s\"], \"command\": \"live_server_start\" },\n    { \"keys\": [\"alt+shift+o\"], \"command\": \"open_current_file_live_server\" },\n    { \"keys\": [\"alt+shift+x\"], \"command\": \"live_server_stop\" }\n]\n```\n\n---\n\n## Settings quick reference\n\n```js\n// LiveServerPlus.sublime-settings (user)\n{\n    \"customBrowser\": \"\",\n    \"openBrowser\": true,\n    \"showInfoMessages\": true,\n    \"verifyTags\": true,\n    \"fullReload\": false,\n    \"liveReload\": false,\n    \"host\": \"127.0.0.1\",\n    // WARNING: use \"0.0.0.0\" only on trusted networks; it exposes the server to your LAN.\n    \"maxThreads\": 64,\n    \"maxWatchedDirs\": 50,\n    \"renderMarkdownPreview\": true,\n    \"markdownScrollSync\": \"editor\", // \"editor\", \"sync\", or false\n    \"ignoreFiles\": [\"**/node_modules/**\", \"**/.git/**\", \"**/__pycache__/**\"],\n    \"logging\": false,\n    \"port\": 5500,\n    \"showOnStatusbar\": true,\n    \"useLocalIp\": false,\n    \"useWebExt\": false,\n    \"wait\": 100\n}\n```\n\nRestart the server after changing settings.\n\n\u003e **Security note:** Binding the server to `0.0.0.0` exposes it to every device on your local network. Only use that host value on trusted networks.\n\n---\n\n## Requirements\n\n- **Sublime Text 4** (Build ≥ 4152)  \n- Browser with WebSocket support (Chrome, Firefox, Edge, Safari)\n\n---\n\n## Known limitations\n\n- Watchdog mode watches up to 50 directories; adjust ignore globs or reduce scope for very large projects. When Live Reload is enabled, only saves inside Sublime trigger refreshes.\n\n---\n\n## Contributing\n\nContributions welcome! Issues and pull requests are welcome.\n\n---\n\n## Vendored dependencies\n\n- **Watchdog** – filesystem events  \n- **PyQRCode** and **pypng** – QR generation\n- **markdown2** – Markdown → HTML conversion \n\nAll vendored under `liveserverplus_lib/vendor/`.\n\n---\n\n## Support\n\nReport bugs/issues on GitHub: \u003chttps://github.com/ifrederico/sublime-liveserverplus/issues\u003e\n\n---\n\n## License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifrederico%2Fsublime-liveserverplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fifrederico%2Fsublime-liveserverplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifrederico%2Fsublime-liveserverplus/lists"}