{"id":15010815,"url":"https://github.com/getnamo/blui-unreal","last_synced_at":"2025-10-04T01:31:19.578Z","repository":{"id":41479712,"uuid":"45425625","full_name":"getnamo/BLUI-Unreal","owner":"getnamo","description":"CEF based HTML UI for the Unreal Engine.","archived":false,"fork":true,"pushed_at":"2025-01-20T04:49:02.000Z","size":641,"stargazers_count":377,"open_issues_count":27,"forks_count":76,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-01-20T05:28:37.520Z","etag":null,"topics":["cef","chromium","html","ue4","ue5","unreal"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"ashea-code/BLUI","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getnamo.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}},"created_at":"2015-11-02T22:14:31.000Z","updated_at":"2025-01-20T04:49:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/getnamo/BLUI-Unreal","commit_stats":null,"previous_names":["getnamo/blui"],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamo%2FBLUI-Unreal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamo%2FBLUI-Unreal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamo%2FBLUI-Unreal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamo%2FBLUI-Unreal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getnamo","download_url":"https://codeload.github.com/getnamo/BLUI-Unreal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235208944,"owners_count":18953003,"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":["cef","chromium","html","ue4","ue5","unreal"],"created_at":"2024-09-24T19:36:19.582Z","updated_at":"2025-10-04T01:31:19.572Z","avatar_url":"https://github.com/getnamo.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![release](https://img.shields.io/github/release/getnamo/BLUI.svg?style=flat-square)](https://github.com/getnamo/BLUI-Unreal/releases)\n![BLUI-logo](https://cloud.githubusercontent.com/assets/1334174/5969395/201a1202-a7f1-11e4-98a4-12bc6793f830.png)\n[![Github All Releases](https://img.shields.io/github/downloads/getnamo/BLUI-Unreal/total.svg)](https://github.com/getnamo/BLUI-Unreal/releases)\n\n## Getnamo Fork Notes\n\nA fork of BLUI that is kept relatively up to date.\n\nLatest release is updated to [CEF 90.0.4430.212](https://bitbucket.org/chromiumembedded/cef/src/4430/). See https://github.com/getnamo/BLUbrowser for repo for cef process build.\n\nTo install check out the latest releases https://github.com/getnamo/BLUI-Unreal/releases and drag and drop *Plugins* folder into your project root folder\n\nUnreal thread: https://forums.unrealengine.com/community/released-projects/29036-blui-open-source-html5-js-css-hud-ui\n\n[Discord Server](https://discord.gg/qfJUyxaW4s)\n\n### Convenience Blueprints\n\nThe native plugin didn't contain any self contained drag and drop examples so I've added some.\n\n![examples](https://i.imgur.com/UOCEHM8.png)\n\n### BluiWidget\n\nA user widget (UMG) blueprint which embeds a BLU texture as an image brush. Contains various utility functions to allow loading and parsing urls easily. Call ```InitBluEye``` with starting url and browser window size to start this widget. See *BluiWorldWidgetActorExample* for an example of how it's used in practice.\n\n\n### BluiWorldWidgetActorExample\n\nEncapsulated *BluiWidget* user widget in an actor. Drag and drop this actor into your scene and it will auto-spawn the required *BluTickActor* to make everything work.\n\n![example output](https://i.imgur.com/bso2ah6.png)\n\n*3 BluiWorldWIdgetActorExample actors with ```youtube.com```, ```blui ue4``` and ```local://test.html``` specified as their URL respectively*\n\n\n#### Url\n\nBy default the actor will check the url for ```local://``` protocol and load local content first if detected. This should be placed inside the following directory: ```{project root}/Content/html```. NB: You can still use the vanilla ```blui://``` protocol which will load content relative to your project root.\n\n![local url](https://i.imgur.com/30hk67Z.png)\n\n*e.g. having a test.html file inside your Content/html folder*\n\n\nBasic URL validity is also tested, but you can safely ignore http:// etc. E.g. just specifying youtube.com will resolve correctly\n\n![](https://i.imgur.com/R6we4jO.png)\n\n\nIf your URL isn't valid however, it will redirect the string as a search term e.g. typing a sentance or a search term.\n\n![auto-search](https://i.imgur.com/iDoXyFy.png)\n\n\nYou can untick *Should Auto Search Invalid Url* to disable this behavior.\n\n#### Resize\nBy default the actor has a BLUI resolution of 1000x1000, you can change this by just changing the user widget draw size.\n\n![resize](https://i.imgur.com/kB8X4I5.png)\n\n\n\n### BluTickActor\n\nSince 4.0.0 - This actor is no longer needed. Ticking happens internally.\n\nOlder verions:\nInstead of ticking in your level bp, I prefer to use a simple actor to do the ticking. Other convenience blueprints may spawn this as necessary so if you use those, you don't ever need to use this directly.\n\n## Demo Project\n\nThanks to @oivio we have the Demo project updated to the latest release. See https://github.com/oivio/BLUI-Demo\n\n### Video of Demo project\n\n[![Demo Project](https://img.youtube.com/vi/R0xylXhBm-0/0.jpg)](https://youtu.be/R0xylXhBm-0)\n\nClick on image to take you to video.\n\n\nWhat is it?\n---------------------------------------\nBLUI is an Unreal Engine 4 plugin that allows easy interaction with the Chromium Embedded Framework. It provides a simple Material Instance and input functions to help streamline the rendering of rich HTML interfaces.\n\nBLUI tries to stay out of the way as much as possible. All rendering of the DOM and processing of the JavaScript happens in a separate process, just like Chromium. BLUI only updates the texture inside the material instance when Chromium requests a redraw, not every tick, saving a bit more processing along the way.\n\nFeatures\n---------------------------------------\n+ Chromium Powered (same thing that powers Google Chrome!)\n+ Fully compatible with every web technology that Chrome/Chromium works with. (HTML5, WebAudio, WebSockets etc.)\n+ No specific ties to ***any*** in game class, simple use Blueprints (or C++) to create a new \"BluEye\" object and grab its material instance, then you can paint it on anything!\n+ Execute JavaScript in the \"browser\" from your game to pass data to the web page\n+ Using `blu_event` JS native function you can pass data from the page's JavaScript back into UE4!\n+ C++ or Blueprints, works with both!\n\nSetting up the editor and project\n---------------------------------------\nThen copy the `BLUI` folder into the \"Plugins\" folder within your **project** directory, and enable the plugin.\n\nRe-generate your project's Visual Studio file and load up the editor. Then check the plugin list to ensure it has been loaded!\n\n\nLoading Local Files\n---------------------------------------\nSet your default URL or use the \"Load URL\" node/method to load a URL that starts with `local://` this will point to the Content/html directory root of the project or the game (if packaged). So if you wanted to load an HTML file from `YourProject/Content/html/UI/file.html`, set the URL to `local://UI/file.html`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetnamo%2Fblui-unreal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetnamo%2Fblui-unreal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetnamo%2Fblui-unreal/lists"}