{"id":13614305,"url":"https://github.com/lightninglabs/lightning-terminal","last_synced_at":"2025-04-12T22:24:34.961Z","repository":{"id":37092029,"uuid":"252564593","full_name":"lightninglabs/lightning-terminal","owner":"lightninglabs","description":"Lightning Terminal: Your Home for Lightning Liquidity","archived":false,"fork":false,"pushed_at":"2024-05-01T05:50:16.000Z","size":13045,"stargazers_count":480,"open_issues_count":126,"forks_count":77,"subscribers_count":32,"default_branch":"master","last_synced_at":"2024-05-01T21:48:26.913Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/lightninglabs.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}},"created_at":"2020-04-02T21:09:32.000Z","updated_at":"2024-05-03T17:47:32.777Z","dependencies_parsed_at":"2023-02-12T04:02:05.651Z","dependency_job_id":"99445262-65a0-428b-8286-81bad3117888","html_url":"https://github.com/lightninglabs/lightning-terminal","commit_stats":{"total_commits":842,"total_committers":26,"mean_commits":32.38461538461539,"dds":0.6793349168646081,"last_synced_commit":"f52b0469a814e1e90ddb1dd714a53bfe3479c99d"},"previous_names":["lightninglabs/shushtar"],"tags_count":88,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flightning-terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flightning-terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flightning-terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lightninglabs%2Flightning-terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lightninglabs","download_url":"https://codeload.github.com/lightninglabs/lightning-terminal/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248638743,"owners_count":21137703,"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":[],"created_at":"2024-08-01T20:00:59.641Z","updated_at":"2025-04-12T22:24:34.924Z","avatar_url":"https://github.com/lightninglabs.png","language":"Go","funding_links":[],"categories":["Tools","Go"],"sub_categories":["Architecture"],"readme":"# Lightning Terminal (LiT)\n\n![CI](https://github.com/lightninglabs/lightning-terminal/workflows/CI/badge.svg)\n\nLightning Terminal (LiT) is a browser-based interface for managing channel liquidity.\n\n![screenshot](./app/src/assets/images/screenshot.png)\n\n## Features\n- Visualize your channels and balances\n- Perform submarine swaps via the [Lightning Loop](https://lightning.engineering/loop) service\n- Classify channels according to your node's operating mode\n- Run a single binary that integrates [`loopd`](https://github.com/lightninglabs/loop),\n  [`poold`](https://github.com/lightninglabs/pool) and\n  [`faraday`](https://github.com/lightninglabs/faraday) daemons all in one\n- Access a preview release of the Pool UI\n- Use Pool to earn sats by opening channels to those needing inbound liquidity\n\n## Installation\nDownload the latest binaries from the [releases](https://github.com/lightninglabs/lightning-terminal/releases) page. \n\nAdditionally, you can find detailed instructions on the [docs.lightning.engineering](https://docs.lightning.engineering/lightning-network-tools/lightning-terminal/get-lit) page.\n\n## Execution\nRun Lightning Terminal with a local `lnd` instance:\n\n```shell\n⛰  ./litd --uipassword=UP48lm4Vjqxy\u003cchange_this_or_you_will_get_robbed\u003e\n```\n\nVisit https://localhost:8443 to access Terminal.\n\nNote that a password with a minimum of 8 characters is required to run Lightning Terminal. In a production environment, it's recommended that you store this password as an environment variable to avoid it being recorded in the command history.\n\nTo use LiT with a remote `lnd` instance please [follow these instructions](./docs/config-lnd-remote.md). If you would like to replace your existing LND instance with the one integrated within LiT please see [configuring Terminal](./docs/config-lnd-integrated.md).\n\n## LND\nNote that LiT requires `lnd` to be built with **all of its subservers** and requires running at least v0.11.0. Download the latest [official release binary](https://github.com/lightningnetwork/lnd/releases/latest) or build `lnd` from source by following the [installation instructions](https://github.com/lightningnetwork/lnd/blob/master/docs/INSTALL.md). If you choose to build `lnd` from source, use the following command to enable all the relevant subservers:\n\n```shell\n⛰  make install tags=\"signrpc walletrpc chainrpc invoicesrpc\"\n```\n\n## Interaction\nIf you plan to run LiT on a remote machine but access the web-interface from your computer you may not want to deal with self-signed certificate browser warnings. To avoid these warnings configure the HTTP server to use a certificate from [Let's Encrypt](https://letsencrypt.org/). View the\n[Let's Encrypt Configuration](./docs/letsencrypt.md) doc for instructions on how to configure this.\n\n## Upgrading\nIf you used command line arguments with previous versions then you don't need to change anything when upgrading. \n\nTo upgrade from v0.1.1-alpha or earlier simply create a `lit.conf` file in your LiT directory. The default location LiT uses depends on your operating system:\n- MacOS: `~/Library/Application Support/Lit/lit.conf`\n- Linux: `~/.lit/lit.conf`\n- Windows: `~/AppData/Roaming/Lit/lit.conf`\n\nMove all the configuration settings specific to LiT from `lnd.conf` to `lit.conf` and remove any previous LiT-specific customizations from the configuration settings in `lnd.conf`. Note that any section headers (`[ Example ]`) in `lit.conf` should be removed or changed to comments (`# Example`). \n\n## Usage\nRead the [walkthrough](docs/WALKTHROUGH.md) document to learn more about how to use LiT.\n\n## Troubleshooting\nIf you encounter any issues please see our [troubleshooting guide](./docs/troubleshooting.md).\n\n## Build from source\nIf you’d prefer to compile from source code please follow [these instructions](./docs/compile.md).\n\n## Compatibility\n\nFull Lightning Terminal functionality can be dependent on running a compatible\nversion of `lnd`. View the table below to ensure that you run a compatible\nversion of `lnd` with the relevant `litd` release.\n\nThis version compatibility dependency table is only relevant when running litd\nin remote mode (meaning that `lnd-mode=remote` is set). It shows the\n**_minimum_** `lnd` version that can be used with different versions of `litd`\n(LiT). The bundled version will always come with the correct,\n[compatible versioning](#daemon-versions-packaged-with-lit).\n\n| LiT               | LND          |\n|-------------------|--------------|\n| **v0.14.1-alpha** | v0.18.5-beta |\n| **v0.14.0-alpha** | v0.18.4-beta |\n| **v0.13.6-alpha** | v0.17.1-beta |\n| **v0.13.5-alpha** | v0.17.1-beta |\n| **v0.13.4-alpha** | v0.17.1-beta |\n| **v0.13.3-alpha** | v0.17.1-beta |\n| **v0.13.2-alpha** | v0.17.0-beta |\n| **v0.13.1-alpha** | v0.17.0-beta |\n| **v0.13.0-alpha** | v0.17.0-beta |\n| **v0.12.5-alpha** | v0.17.0-beta |\n| **v0.12.4-alpha** | v0.17.0-beta |\n| **v0.12.3-alpha** | v0.16.0-beta |\n| **v0.12.2-alpha** | v0.16.0-beta |\n| **v0.12.1-alpha** | v0.16.0-beta |\n| **v0.12.0-alpha** | v0.16.0-beta |\n| **v0.11.0-alpha** | v0.16.0-beta |\n| **v0.10.5-alpha** | v0.16.0-beta |\n| **v0.10.4-alpha** | v0.16.0-beta |\n| **v0.10.2-alpha** | v0.16.0-beta |\n| **v0.10.1-alpha** | v0.16.0-beta |\n| **v0.10.0-alpha** | v0.16.0-beta |\n| **v0.9.2-alpha**  | v0.16.0-beta |\n| **v0.9.1-alpha**  | v0.16.0-beta |\n| **v0.9.0-alpha**  | v0.16.0-beta |\n| **v0.8.6-alpha**  | v0.15.4-beta |\n| **v0.8.5-alpha**  | v0.15.4-beta |\n| **v0.8.4-alpha**  | v0.15.1-beta |\n| **v0.8.3-alpha**  | v0.15.1-beta |\n| **v0.8.2-alpha**  | v0.15.1-beta |\n| **v0.8.1-alpha**  | v0.15.1-beta |\n| **v0.8.0-alpha**  | v0.15.1-beta |\n| **v0.7.1-alpha**  | v0.14.3-beta |\n| **v0.7.0-alpha**  | v0.14.3-beta |\n| **v0.6.7-alpha**  | v0.13.3-beta |\n| **v0.6.6-alpha**  | v0.13.3-beta |\n| **v0.6.5-alpha**  | v0.13.3-beta |\n| **v0.6.4-alpha**  | v0.13.3-beta |\n| **v0.6.3-alpha**  | v0.13.3-beta |\n| **v0.6.2-alpha**  | v0.13.3-beta |\n| **v0.6.1-alpha**  | v0.13.3-beta |\n| **v0.6.0-alpha**  | v0.13.3-beta |\n| **v0.5.2-alpha**  | v0.12.0-beta |\n| **v0.5.1-alpha**  | v0.12.0-beta |\n| **v0.5.0-alpha**  | v0.12.0-beta |\n| **v0.4.1-alpha**  | v0.11.1-beta |\n| **v0.4.0-alpha**  | v0.11.1-beta |\n| **v0.3.4-alpha**  | v0.11.1-beta | \n| **v0.3.3-alpha**  | v0.11.1-beta | \n| **v0.3.2-alpha**  | v0.11.1-beta | \n| **v0.3.1-alpha**  | v0.11.1-beta |\n| **v0.3.0-alpha**  | v0.11.1-beta |\n| **v0.2.0-alpha**  | v0.11.0-beta |\n\nLiT offers two main operating modes, one in which [`lnd` is running inside the\nLiT process (called \"lnd integrated mode\", set by `lnd-mode=integrated` config\noption)](docs/config-lnd-integrated.md) and one in which [`lnd` is running in\na standalone process on the same or remote machine (called \"lnd remote mode\",\nset by `lnd-mode=remote` config option)](docs/config-lnd-remote.md).\n\nIn addition to those main modes, the individual bundled daemons (Faraday, Loop\nand Pool) can be toggled to be integrated or remote as well, or as disabled.\nThis offers a large number of possible configuration combinations, of which not\nall are fully supported due to technical reasons.\n\nThe following table shows the supported combinations:\n\n|                                        | `lnd-mode=integrated` | `lnd-mode=remote` |\n|----------------------------------------|-----------------------|-------------------|\n| `faraday-mode=integrated`              | X                     | X                 |\n| `loop-mode=integrated`                 | X                     | X                 |\n| `pool-mode=integrated`                 | X                     | X                 |\n| `taproot-assets-mode=integrated`        | X                     | X                 |\n| `faraday-mode=remote`                  |                       | X                 |\n| `loop-mode=remote`                     |                       | X                 |\n| `pool-mode=remote`                     |                       | X                 |\n| `taproot-assets-mode=remote`            |                       | X                 |\n| `faraday-mode=disable`                 | X                     | X                 |\n| `loop-mode=disable`                    | X                     | X                 |\n| `pool-mode=disable`                    | X                     | X                 |\n| `taproot-assets-mode=disable`           | X                     | X                 |\n| `lnd` running in \"stateless init\" mode | X                     |                   |\n\nNOTE: Taproot Assets **Channel** functionality is only available when both `lnd`\nand `tapd` are running in the same process (by setting both\n`lnd-mode=integrated` and `taproot-assets-mode=integrated`). Remote mode support\nwill be added in the future.\n\n## Daemon Versions packaged with LiT\n\n| LiT               | LND          | Loop         | Faraday       | Pool         | Taproot Assets |\n|-------------------|--------------|--------------|---------------|--------------|--------------|\n| **v0.14.1-alpha** | v0.18.5-beta | v0.29.0-beta | v0.2.14-alpha | v0.6.5-beta  | v0.5.1-alpha |\n| **v0.14.0-alpha** | v0.18.4-beta | v0.29.0-beta | v0.2.13-alpha | v0.6.5-beta  | v0.5.0-alpha |\n| **v0.13.6-alpha** | v0.18.3-beta | v0.28.8-beta | v0.2.13-alpha | v0.6.5-beta  | v0.4.1-alpha |\n| **v0.13.5-alpha** | v0.18.3-beta | v0.28.8-beta | v0.2.13-alpha | v0.6.5-beta  | v0.4.1-alpha |\n| **v0.13.4-alpha** | v0.18.3-beta | v0.28.7-beta | v0.2.13-alpha | v0.6.5-beta  | v0.4.1-alpha |\n| **v0.13.3-alpha** | v0.18.2-beta | v0.28.6-beta | v0.2.13-alpha | v0.6.5-beta  | v0.4.1-alpha |\n| **v0.13.2-alpha** | v0.18.2-beta | v0.28.5-beta | v0.2.13-alpha | v0.6.5-beta  | v0.3.3-alpha |\n| **v0.13.1-alpha** | v0.18.1-beta | v0.28.5-beta | v0.2.13-alpha | v0.6.5-beta  | v0.3.3-alpha |\n| **v0.13.0-alpha** | v0.18.0-beta | v0.28.5-beta | v0.2.13-alpha | v0.6.5-beta  | v0.3.3-alpha |\n| **v0.12.5-alpha** | v0.17.5-beta | v0.28.1-beta | v0.2.13-alpha | v0.6.4-beta  | v0.3.3-alpha |\n| **v0.12.4-alpha** | v0.17.4-beta | v0.28.0-beta | v0.2.13-alpha | v0.6.4-beta  | v0.3.3-alpha |\n| **v0.12.3-alpha** | v0.17.4-beta | v0.27.0-beta | v0.2.11-alpha | v0.6.4-beta  | v0.3.3-alpha |\n| **v0.12.2-alpha** | v0.17.3-beta | v0.26.6-beta | v0.2.11-alpha | v0.6.4-beta  | v0.3.2-alpha |\n| **v0.12.1-alpha** | v0.17.1-beta | v0.26.5-beta | v0.2.11-alpha | v0.6.4-beta  | v0.3.1-alpha |\n| **v0.12.0-alpha** | v0.17.0-beta | v0.26.4-beta | v0.2.11-alpha | v0.6.4-beta  | v0.3.0-alpha |\n| **v0.11.0-alpha** | v0.17.0-beta | v0.26.3-beta | v0.2.11-alpha | v0.6.4-beta  | v0.2.3-alpha |\n| **v0.10.5-alpha** | v0.16.4-beta | v0.26.2-beta | v0.2.11-alpha | v0.6.4-beta  | v0.2.3-alpha |\n| **v0.10.4-alpha** | v0.16.4-beta | v0.25.2-beta | v0.2.11-alpha | v0.6.4-beta  | v0.2.3-alpha |\n| **v0.10.2-alpha** | v0.16.4-beta | v0.25.2-beta | v0.2.11-alpha | v0.6.4-beta  | v0.2.2-alpha |\n| **v0.10.1-alpha** | v0.16.3-beta | v0.24.1-beta | v0.2.11-alpha | v0.6.4-beta  | v0.2.0-alpha |\n| **v0.10.0-alpha** | v0.16.2-beta | v0.23.0-beta | v0.2.11-alpha | v0.6.2-beta  | v0.2.0-alpha |\n| **v0.9.2-alpha**  | v0.16.2-beta | v0.23.0-beta | v0.2.11-alpha | v0.6.2-beta  | n/a          |\n| **v0.9.1-alpha**  | v0.16.1-beta | v0.23.0-beta | v0.2.11-alpha | v0.6.2-beta  | n/a          |\n| **v0.9.0-alpha**  | v0.16.0-beta | v0.22.0-beta | v0.2.10-alpha | v0.6.2-beta  | n/a          |\n| **v0.8.6-alpha**  | v0.15.5-beta | v0.21.0-beta | v0.2.9-alpha  | v0.6.1-beta  | n/a          |\n| **v0.8.5-alpha**  | v0.15.5-beta | v0.20.2-beta | v0.2.9-alpha  | v0.6.1-beta  | n/a          |\n| **v0.8.4-alpha**  | v0.15.5-beta | v0.20.1-beta | v0.2.9-alpha  | v0.5.8-alpha | n/a          |\n| **v0.8.3-alpha**  | v0.15.4-beta | v0.20.1-beta | v0.2.8-alpha  | v0.5.8-alpha | n/a          |\n| **v0.8.2-alpha**  | v0.15.3-beta | v0.20.1-beta | v0.2.8-alpha  | v0.5.8-alpha | n/a          |\n| **v0.8.1-alpha**  | v0.15.2-beta | v0.20.1-beta | v0.2.8-alpha  | v0.5.8-alpha | n/a          |\n| **v0.8.0-alpha**  | v0.15.1-beta | v0.20.1-beta | v0.2.8-alpha  | v0.5.8-alpha | n/a          |\n| **v0.7.1-alpha**  | v0.15.0-beta | v0.19.1-beta | v0.2.8-alpha  | v0.5.7-alpha | n/a          |\n| **v0.7.0-alpha**  | v0.15.0-beta | v0.19.1-beta | v0.2.8-alpha  | v0.5.7-alpha | n/a          |\n| **v0.6.7-alpha**  | v0.14.3-beta | v0.18.0-beta | v0.2.7-alpha  | v0.5.6-alpha | n/a          |\n| **v0.6.6-alpha**  | v0.14.3-beta | v0.18.0-beta | v0.2.7-alpha  | v0.5.6-alpha | n/a          |\n| **v0.6.5-alpha**  | v0.14.2-beta | v0.15.1-beta | v0.2.7-alpha  | v0.5.5-alpha | n/a          |\n| **v0.6.4-alpha**  | v0.14.2-beta | v0.15.1-beta | v0.2.7-alpha  | v0.5.4-alpha | n/a          |\n| **v0.6.3-alpha**  | v0.14.2-beta | v0.15.1-beta | v0.2.7-alpha  | v0.5.4-alpha | n/a          |\n| **v0.6.2-alpha**  | v0.14.1-beta | v0.15.1-beta | v0.2.7-alpha  | v0.5.4-alpha | n/a          |\n| **v0.6.1-alpha**  | v0.14.1-beta | v0.15.1-beta | v0.2.7-alpha  | v0.5.2-alpha | n/a          |\n| **v0.5.3-alpha**  | v0.13.3-beta | v0.14.1-beta | v0.2.6-alpha  | v0.5.0-alpha | n/a          |\n| **v0.5.2-alpha**  | v0.13.3-beta | v0.14.1-beta | v0.2.6-alpha  | v0.5.0-alpha | n/a          |\n| **v0.5.1-alpha**  | v0.13.0-beta | v0.14.1-beta | v0.2.6-alpha  | v0.5.0-alpha | n/a          |\n| **v0.5.0-alpha**  | v0.13.0-beta | v0.14.1-beta | v0.2.6-alpha  | v0.5.0-alpha | n/a          |\n| **v0.4.1-alpha**  | v0.12.1-beta | v0.11.4-beta | v0.2.3-alpha  | v0.4.4-alpha | n/a          |\n| **v0.4.0-alpha**  | v0.12.0-beta | v0.11.2-beta | v0.2.3-alpha  | v0.4.3-alpha | n/a          |\n| **v0.3.4-alpha**  | v0.11.1-beta | v0.11.2-beta | v0.2.2-alpha  | v0.3.4-alpha | n/a          |\n| **v0.3.3-alpha**  | v0.11.1-beta | v0.11.2-beta | v0.2.2-alpha  | v0.3.4-alpha | n/a          |\n| **v0.3.2-alpha**  | v0.11.1-beta | v0.11.1-beta | v0.2.2-alpha  | v0.3.4-alpha | n/a          |\n| **v0.3.1-alpha**  | v0.11.1-beta | v0.11.1-beta | v0.2.2-alpha  | v0.3.3-alpha | n/a          |\n| **v0.3.0-alpha**  | v0.11.1-beta | v0.11.0-beta | v0.2.2-alpha  | v0.3.2-alpha | n/a          |\n| **v0.2.0-alpha**  | v0.11.1-beta | v0.10.0-beta | v0.2.1-alpha  | n/a          | n/a          |\n| **v0.1.1-alpha**  | v0.11.0-beta | v0.8.1-beta  | v0.2.0-alpha  | n/a          | n/a          |\n| **v0.1.0-alpha**  | v0.10.3-beta | v0.6.5-beta  | v0.2.0-alpha  | n/a          | n/a          |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightninglabs%2Flightning-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flightninglabs%2Flightning-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flightninglabs%2Flightning-terminal/lists"}