{"id":21464222,"url":"https://github.com/tbsniller/piccap","last_synced_at":"2025-05-16T08:04:59.986Z","repository":{"id":37598695,"uuid":"367739894","full_name":"TBSniller/piccap","owner":"TBSniller","description":"PicCap - Hyperion Sender App | Ambilight for LG WebOS TVs","archived":false,"fork":false,"pushed_at":"2025-02-21T17:28:09.000Z","size":104257,"stargazers_count":336,"open_issues_count":14,"forks_count":36,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-08T19:25:14.339Z","etag":null,"topics":["ambilight","homebrew","hyperion","lg","webos"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/TBSniller.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":"2021-05-15T22:18:50.000Z","updated_at":"2025-03-18T12:48:12.000Z","dependencies_parsed_at":"2024-12-13T15:17:48.375Z","dependency_job_id":"b2586e58-4ce3-475b-ad30-57ffd12dac1e","html_url":"https://github.com/TBSniller/piccap","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TBSniller%2Fpiccap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TBSniller%2Fpiccap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TBSniller%2Fpiccap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TBSniller%2Fpiccap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TBSniller","download_url":"https://codeload.github.com/TBSniller/piccap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254493378,"owners_count":22080126,"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":["ambilight","homebrew","hyperion","lg","webos"],"created_at":"2024-11-23T07:30:20.908Z","updated_at":"2025-05-16T08:04:54.969Z","avatar_url":"https://github.com/TBSniller.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PicCap - Hyperion Sender App | Ambilight for LG WebOS TVs \n\n  \n## What's this?\n\n### PicCap?    \nPicCap is an frontend app, which you can install on your TV, to make TV content capturing as easy as possible. It ships and controls the seperated [hyperion-webos](https://github.com/webosbrew/hyperion-webos) background native service, which uses capture interfaces on your TV based on reverse engineering, proccesses the output and sends as result a low quality image to a receiver like Hyperion's flatbuffer server.  \nOn newer TVs there is no official way for capturing DRM-protected content like from Netflix or Amazon. This restriction doesn't take place for content comming from an HDMI input.  \nSo currently as a workaround you can play your media using your PC, FireTV-Stick or Chromecast and still enjoy your LEDs.\n\n### Hyperion?  \n[hyperion.ng](https://github.com/hyperion-project/hyperion.ng) basicly is a server service, which transforms incomming image data to an LED output. The idea is to have an ambilight like it's known from Philipps TVs.\nIt is used in DIY-environments, like builded up in [this tutorial](https://github.com/TBSniller/piccap/blob/main/docs/DIY_Ambilight.md).  \nYou can also run [Hyperion.ng webOS loader](https://github.com/webosbrew/hyperion.ng-webos-loader) or it's fork [HyperHDR webOS loader](https://github.com/webosbrew/hyperhdr-webos-loader) directly on your webOS TV, so you don't need any further hardware, expect of your LED driver. Both apps can be found in [Homebrew Channels app repository](https://repo.webosbrew.org/apps/).  \n  \nhttps://user-images.githubusercontent.com/51515147/192116249-f5080f02-3566-4c94-b9e1-bdb11aba2698.mp4\n\nThis footage is captured on a webOS5-TV using vtCapture as library.\n\n## How to install  \n\n### What do you need?  \n- [Root access](https://cani.rootmy.tv) to your TV  \n- webOS 3.4 or above  \n- Latest version of [Homebrew Channel](https://github.com/webosbrew/webos-homebrew-channel) installed, as we take use of its elevate-service script  \n- Brain with some basic knowledge - We haven't encountered any bricks, but standard no warranty clause applies\n\n### Easy way\nOpen Homebrew Channel and install PicCap directly from there.  \n  \n### Manual way\nFirst you will have to [build](https://github.com/TBSniller/piccap#development) it from scratch, or download pre-compiled IPK from [releases](https://github.com/TBSniller/piccap/releases).  \n  \n```\n# Copy IPK to TV \nscp /home/[USER]/downloads/org.webosbrew.piccap_[version]_all.ipk root@[TVIP]:/tmp/org.webosbrew.piccap_[version]_all.ipk\n\n# On TV install IPK\nluna-send -i -f luna://com.webos.appInstallService/dev/install '{\"id\":\"org.webosbrew.piccap\",\"ipkUrl\":\"/tmp/org.webosbrew.piccap_[version]_all.ipk\",\"subscribe\":true}'\n```\n  \n## How to use\n### First start  \nWait a few secounds to let the service elevate root permissions through Homebrew Channel-Service. Check status message in bottom right corner, to see when it's done.\n  \n  \n### Settings \n - If you use hyperion.ng or HyperHDR loader, you will have to fill `127.0.0.1` as IP address. \n - Change priority if you have other capture or effect sources for your Hyperion or HyperHDR instance.  \n\n### Backends\nWe use different libraries to capture TVs content. These are used by hyperion-webos and described [here](https://github.com/webosbrew/hyperion-webos/tree/main#backends).  \n\n### Advanced settings\nSome TV models are comptabile with a specific backend, but require a slightly different routine to work reliably. You can find an explaination for  these so called quirks [here](https://github.com/webosbrew/hyperion-webos/tree/main#quirks).\n\n## Development\n### Dependencies\nTo build PicCap and hyperion-webos you will need:  \n- [Node.js](https://nodejs.org/en/download/)  \n- [buildroot-nc4](https://github.com/openlgtv/buildroot-nc4)  \n\nYou will also need `clang-format-14` if you want to contribute.  \n\n### How to build  \nWe have tried to make build proccess as easy as possible. After building all files can be found in `./build`.\n```\n# Setup buildroot-nc4 (needed for hyperion-webos)\ncd /desired/path\nwget -O toolchain.tar.gz $TOOLCHAIN_URL_FROM_RELEASES\ntar -xvzf toolchain.tar.gz\nrm toolchain.tar.gz\narm-webos-linux-gnueabi_sdk-buildroot/relocate-sdk.sh\nexport TOOLCHAIN_FILE=/desired/path/arm-webos-linux-gnueabi_sdk-buildroot/share/buildroot/toolchainfile.cmake\n\n# Clone project and submodules\ngit clone --recursive https://github.com/TBSniller/piccap.git\ncd ./piccap\n\n# Install node dependencies\nnpm install\n\n# Build\nnpm run-script build-all        # Build PicCap \u0026 hyperion-webos + deps\nnpm run-script build-frontend   # Build PicCap only\nnpm run-script build-backend    # Build hyperion-webos + deps only\n\n# Package IPK-file for TV installation\nnpm run-script package\n```  \n\n## Other\n\n### Known issues  \n**Expect bugs - This app is still in early development**  \nNo issues are known so far, if you find one, feel free to raise an issue!  \n\nPlease see [hyperion-webos#known-issues](https://github.com/webosbrew/hyperion-webos/tree/main#known-issues) for issues regarding the backend service. - This only is the frontend application and has nothing to do with capture related things!  \nVersion tracker is available in [hyperion-webos#16](https://github.com/webosbrew/hyperion-webos/issues/16). \n\n### Credits\nThis project would never ever exists without help from [@Mariotaku](https://github.com/mariotaku) and [@Informatic](https://github.com/Informatic).\nBoth programmed important things at the beginning of this whole ambilight project. [@tuxuser](https://github.com/tuxuser) also made some important changes in the mid of this project.  \nShare them some love if you can, they teached and showed me alot!  \n\nYou should also check out the other contributors. Some nice enhancements wouldn't be there without them :)  \n  \nCheck out [OpenLGs-Discord](https://discord.gg/9sqAgHVRhP) server, if you have some questions. You will find a very helpful community. \u003c3  \n\n### Screenshots\n![Main](https://user-images.githubusercontent.com/51515147/192116360-efd6483a-8dc7-4b61-af27-d428f90740a3.jpg)  \n![Settings](https://user-images.githubusercontent.com/51515147/192116365-1f9a7590-7a88-4bfd-924f-3b8bf9ae47b6.jpg)  \n![Advanced settings](https://user-images.githubusercontent.com/51515147/192116371-21387541-7c56-4866-b7fd-23246a9a4d2e.jpg)  \n![Logs](https://user-images.githubusercontent.com/51515147/192116386-df4e5e3c-7260-451e-8685-69a69a3abc0b.jpg)  \n![About](https://user-images.githubusercontent.com/51515147/192116388-6dce877d-41be-41b1-922e-630783fbca7c.jpg)  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbsniller%2Fpiccap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftbsniller%2Fpiccap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbsniller%2Fpiccap/lists"}