Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/locaal-ai/obs-urlsource

OBS plugin to fetch data from a URL or file, connect to an API or AI service, parse responses and display text, image or audio on scene
https://github.com/locaal-ai/obs-urlsource

api http live-streaming livestream obs obs-plugin obs-studio obs-studio-plugin plugin real-time-data url

Last synced: 3 days ago
JSON representation

OBS plugin to fetch data from a URL or file, connect to an API or AI service, parse responses and display text, image or audio on scene

Host: GitHub
URL: https://github.com/locaal-ai/obs-urlsource
Owner: locaal-ai
License: gpl-2.0
Created: 2023-07-26T13:33:07.000Z (over 1 year ago)
Default Branch: master
Last Pushed: 2024-10-28T02:00:45.000Z (16 days ago)
Last Synced: 2024-11-06T02:25:27.328Z (7 days ago)
Topics: api, http, live-streaming, livestream, obs, obs-plugin, obs-studio, obs-studio-plugin, plugin, real-time-data, url
Language: C++
Homepage: https://obsproject.com/forum/resources/url-api-source-fetch-live-data-and-display-it-on-screen.1756/
Size: 464 KB
Stars: 180
Watchers: 8
Forks: 24
Open Issues: 17
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        # URL/API Source - Connect Anything to OBS



[![GitHub](https://img.shields.io/github/license/locaal-ai/obs-urlsource)](https://github.com/locaal-ai/obs-urlsource/blob/main/LICENSE)

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/locaal-ai/obs-urlsource/push.yaml)](https://github.com/locaal-ai/obs-urlsource/actions/workflows/push.yaml)

[![Total downloads](https://img.shields.io/github/downloads/locaal-ai/obs-urlsource/total)](https://github.com/locaal-ai/obs-urlsource/releases)

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/locaal-ai/obs-urlsource)](https://github.com/locaal-ai/obs-urlsource/releases)

[![Discord](https://img.shields.io/discord/1200229425141252116)](https://discord.gg/KbjGU2vvUz)





Download









## Introduction

The URL/API Source is a plugin for [OBS Studio](https://obsproject.com) that allows fetcing data from a URL, API endpoint or file and displays it as text, image or even audio. [OBS Forums page](https://obsproject.com/forum/resources/url-api-source-fetch-live-data-and-display-it-on-screen.1756/) | [Blog post](https://www.morethantechnical.com/2023/08/10/url-api-source-obs-plugin/)

If this free plugin has been valuable to you consider adding a ⭐ to this GH repo, rating it [on OBS](https://obsproject.com/forum/resources/url-api-source-fetch-live-data-and-display-it-on-screen.1756/), subscribing to [my YouTube channel](https://www.youtube.com/@royshilk) where I post updates, and supporting my work on [GitHub](https://github.com/sponsors/royshil), [Patreon](https://www.patreon.com/RoyShilkrot) or [OpenCollective](https://opencollective.com/locaal-ai)

### Usage Tutorials

Watch quick tutorials on how to use and setup the URL/API source on your OBS scene.



  

    

  

  

    

  

  

    

  



Additional things to do with URL/API source to upgrade your content:

- [HTML live website Scraping (18 min)](https://youtu.be/kgAOCijJ51Q)

- [Use ChatGPT](https://youtu.be/4BTmoKr0YMw)

- [Live Narration of your content with GPT](https://youtu.be/2wJ72DcgBew)

- [Text-to-Speech with Coqui](https://youtu.be/kltJbg9hH4s)

- [Live data from Google Sheets with API](https://www.youtube.com/watch?v=Y4ND9Y7IUJE)

- [Send captions to YouTube API](https://www.youtube.com/watch?v=E7HKbO6CP_c)

- [Get VSCode live data with API](https://www.youtube.com/watch?v=GqaIbSZe69o)

- [Translate with DeepL API](https://youtu.be/ryWBIEmVka4)

#### Inspiration

Out of ideas on what to do with URL/API Source? Here's a repo with 1,000s of public APIs https://github.com/public-apis/public-apis

### Dynamic Templating

The URL source supports both input and output templating using the [Inja](https://github.com/pantor/inja) engine.

Output templates include `{{output}}` in case of a singular extraction from the response or `{{output1}},{{output2}},...` in case of multiple extracted value. In addition the `{{body}}` variable contains the entire body of the response in case of JSON. Advanced output templating functions can be achieved through [Inja](https://github.com/pantor/inja) like looping over arrays, etc.







The input template works for the URL (querystring or REST path) or the POST body







Use the `{{input}}` variable to insert the output from a Text source. Inja advanced templates are available too.

A special function `strftime` is available for formatting the current time using conventions from C++ STL ([strftime](https://en.cppreference.com/w/cpp/chrono/c/strftime)), as well as `urlencode` which is useful for dynamic input in the querystring.

#### HTML Subset

The internal template renderer supports HTML4 and CSS with a [reduced subset of feautures](https://doc.qt.io/qt-6/richtext-html-subset.html).

It is quite powerful and can render tables and apply various styling to the text.

Image render is supported with the `` tag, and external URLs are supported as well. For example `` could be used to dynamically render an image URL coming from the response.

### Code Walkthrough

Watch an explanation of the major parts of the code and how they work together.



  

    

  


  https://youtu.be/TiluUg1LxcQ



Features:

- HTTP request types: GET, POST

- Request headers (for e.g. API Key or Auth token)

- Request body for POST

- Multiple dynamic inputs from several Text or Image sources (base64)

- Output parsing: JSON (JSONPointer & JSONPath), XML/HTML (XPath & XQuery), Key-Value, Regex and CSS selectors

- Update timer for live updating data

- Test of the request to find the right parsing

- Output styling (font, color, etc.) and formatting (via regex post processing)

- Output Image (via image URL or image data on the response)

- Output text to external Text Source and audio to external Media Source

- Output to multiple sources with one request (Output Mapping)

- Multi-value (array, union) parsed output capture, object unpacking (via Inja)

- Dynamic input aggregations (time-based, "empty"-based)

- Websocket support

Coming soon:

- Authentication (Basic, Digest, OAuth)

- More parsing options (CSV, etc.)

- More request types (HTTP PUT / DELETE / PATCH, and GraphQL)

- More output formats (Markdown, slim, reStructured, HAML, etc.)

Check out our other plugins:

- [Background Removal](https://github.com/locaal-ai/obs-backgroundremoval) removes background from webcam without a green screen.

- [Detect](https://github.com/locaal-ai/obs-detect) will find and track >80 types of objects in any source that provides an image in real-time

- [LocalVocal](https://github.com/locaal-ai/obs-localvocal) speech AI assistant plugin for real-time, local transcription (captions), translation and more language functions

- [Polyglot](https://github.com/locaal-ai/obs-polyglot) translation AI plugin for real-time, local translation to hunderds of languages

- 🚧 Experimental 🚧 [CleanStream](https://github.com/locaal-ai/obs-cleanstream) for real-time filler word (uh,um) and profanity removal from live audio stream

If you like this work, which is given to you completely free of charge, please consider supporting it on GitHub: https://github.com/sponsors/royshil

## Download

Check out the [latest releases](https://github.com/locaal-ai/obs-urlsource/releases) for downloads and install instructions.

## Building

The plugin was built and tested on Mac OSX  (Intel & Apple silicon), Windows and Linux.

Start by cloning this repo to a directory of your choice.

### Getting Submodules

Before compiling, you need to fetch all the submodules. After cloning the repository, run the following command in the root directory of the project:

```sh

git submodule update --init --recursive

```

This will initialize and fetch all the necessary submodules for the project.

### Mac OSX

Using the CI pipeline scripts, locally you would just call the zsh script. By default this builds a universal binary for both Intel and Apple Silicon. To build for a specific architecture please see `.github/scripts/.build.zsh` for the `-arch` options.

```sh

$ ./.github/scripts/build-macos -c Release

```

#### Install

The above script should succeed and the plugin files (e.g. `obs-urlsource.plugin`) will reside in the `./release/Release` folder off of the root. Copy the `.plugin` file to the OBS directory e.g. `~/Library/Application Support/obs-studio/plugins`.

To get `.pkg` installer file, run for example

```sh

$ ./.github/scripts/package-macos -c Release

```

(Note that maybe the outputs will be in the `Release` folder and not the `install` folder like `pakage-macos` expects, so you will need to rename the folder from `build_x86_64/Release` to `build_x86_64/install`)

### Linux (Ubuntu)

Use the CI scripts again

```sh

$ ./.github/scripts/build-linux.sh

```

Copy the results to the standard OBS folders on Ubuntu

```sh

$ sudo cp -R release/RelWithDebInfo/lib/* /usr/lib/x86_64-linux-gnu/

$ sudo cp -R release/RelWithDebInfo/share/* /usr/share/

```

Note: The official [OBS plugins guide](https://obsproject.com/kb/plugins-guide) recommends adding plugins to the `~/.config/obs-studio/plugins` folder.

### Windows

Use the CI scripts again, for example:

```powershell

> .github/scripts/Build-Windows.ps1 -Target x64 -CMakeGenerator "Visual Studio 17 2022"

```

The build should exist in the `./release` folder off the root. You can manually install the files in the OBS directory.