meme-box

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #golang #go #android #machine-learning #windows #awesome #cli #awesome-list #mcp #open-source

(★ 122)

Manage and trigger media in OBS as a browser source

meme-box 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Meme-Box | [Getting Started](#getting-started) | [How to contribute](#how-to-help--contribute)

[![All Contributors](https://img.shields.io/badge/all_contributors-11-orange.svg?style=flat-square)](https://raw.githubusercontent.com/negue/meme-box/develop/)

A complete management app for [`image / audio / video / iframe / widgets`](/tutorials/type_overview.md) "media" to be used inside OBS. Or trigger other custom actions.

|**Media Setup Example + Mobile View**|**Setup a Twitch-Trigger**|
|--|--|
|![memebox example setup gif](https://raw.githubusercontent.com/negue/meme-box/develop/assets/memebox_example_mobile_view.gif)|![memebox example twitch trigger gif](https://raw.githubusercontent.com/negue/meme-box/develop/assets/memebox_example_twitch.gif)|

## Installation

### Pre-built binaries

[Download latest release!](https://github.com/negue/meme-box/releases) (currently a bit ouf of date, new release soon) - [latest nightly Builds](https://github.com/negue/meme-box-nightly/releases)

### From source

If you would like to build MemeBox from source, have a look at our dedicated [BUILD.md](BUILD.md).

### From AUR

If you're an Arch Linux user, you can install directly from the [AUR](https://aur.archlinux.org), using one of the [AUR helpers](https://wiki.archlinux.org/title/AUR_helpers).

For example, with `paru`:

```sh
paru -S memebox
```

## Working Features

<table>
 <tr>
 <th>Show Media</th>
 <th>Screens (in OBS) </th>
 <th colspan=2>Triggers </th>
 </tr>
 <tr>
 <td>Images</td>
 <td rowspan=7>

Animations on show / hide
[Visibility][URL_ADVANCED_SETTINGS]:
- Play (on a trigger)
- Toggle (per trigger)
- Always Visible

[Custom Position per Media / Screen][URL_ADVANCED_SETTINGS]:
- Fullscreen
- Fixed (on a position)
- Centered
- Random

Misc:
- [Custom CSS per Media / Screen][URL_ADVANCED_SETTINGS]
- drag&drop for better position items
- rotate/size/warp items
</td>
<td rowspan=7 valign="top">

[✅ `Streamdeck Plugin`][STREAMDECK_PLUGIN]
 
[✅ `Deckboard Plugin`](https://github.com/gigili/deckboard-memebox)
 
✅ Timers 
✅ Mobile View 
✅ Twitch Events 
<ul>
 <li> Bits </li>
 <li> Channel Points </li>
 <li> Message </li>
 <li> Raid </li>
 <li> User Ban </li>
 <li> Subscription </li>
 <li> Gift Sub </li>
</ul>

</td>
 </tr>
 <tr>
 <td>Videos</td>
 </tr>
 <tr>
 <td>Iframes</td>
 </tr>
 <tr>
 <td>Widgets</td>
 </tr>
 <tr>
 <td>Play Audio</td>
 </tr>
 <tr>
 <th>Actions</th>
 </tr>

[`Trigger multiple / random Media`][URL_RECIPE]
</td>
 </tr>
 <tr>
 <th colspan=3>Scripts (Action)</th>
 </tr>

- Trigger other Actions with custom logic/timeouts/overrides
- Trigger OBS functions
- Write to Twitch Chat
</td>

</tr>
 <tr>
 <th colspan=3>Permanent Script</th>
 </tr>

- Same as Scripts just that those will run and stay active all the time.
- Used for Bots or other functionalities
- React on custom callbacks from Twitch / OBS Events
- Create your own WebSocket-Server - see [`Script-API examples`][URL_SCRIPTS]
</td>
 </tr>

<tr>
 <th colspan=3>API for Developers</th>
 </tr>

- Trigger Actions with WebSockets
- Receive all Twitch Events using WebSockets `/ws/twitch_events` to use in other Apps / Overlays
- Twitch Helix REST bridge `/api/twitchData/helix/*` instead of `https://api.twitch.tv/helix/`
 </td>
 </tr>
</table>

-----

## Getting Started

> Note: These are the current `Getting Started` / Tutorials for this branch.
>
> To see the updated `Getting Started` / Tutorials from the released version - [click here!](https://github.com/negue/meme-box/tree/release#getting-started)

[`Installation and Getting Started`](https://github.com/meme-box/memebox-101/blob/main/00/README.md)

`Advanced`:

- [`Trigger multiple / randoms`][URL_RECIPE]
- [`Screen / Media Settings`][URL_ADVANCED_SETTINGS]
- [`Scripts`][URL_SCRIPTS]
- [`Widgets`][URL_WIDGETS]

[URL_RECIPE]: tutorials/recipe.md
[URL_SCRIPTS]: tutorials/scripts.md
[URL_WIDGETS]: tutorials/widgets.md
[URL_ADVANCED_SETTINGS]: ./tutorials/screen_media_advanced_settings.md
[STREAMDECK_PLUGIN]: ./memebox-streamdeck/Release/com.memebox.memebox-streamdeck.streamDeckPlugin

___

## Roadmap

### 2023.1 (maybe 2024.1, depending how long it takes)

- Main Feature: [Refactor Trigger System / Config](https://github.com/negue/meme-box/pull/560)
  - Easier way to add more types of triggers
  - Also adds the command blocks per trigger (easier way to just "do" stuff)
 
Dependencies for that: ^
  - https://github.com/negue/meme-box/pull/558 &
  - a current big refactor to how the repository is working internally (NPM -> PNPM)
    - these changes will be hopefully soon(TM) done/merged (Current Date of Writing this: 14th of November 2023)
    - been already working on this for 3 months... yay.

### [Future Version](ROADMAP.md)

## How to help / contribute?
* Improve Docs / Translations
* Find bugs
* Suggestions to make `things` (UI, Text, Docs etc) more understandable
* Help fix bugs / improve features
  * [Good First Issues](https://github.com/negue/meme-box/labels/good%20first%20issue)
  * [Open for Contribution](https://github.com/negue/meme-box/labels/open%20for%20contribution)
  * [Developers Sanity](https://github.com/negue/meme-box/labels/developers%20sanity)
  * or all other Issue, in case I missed to label them: https://github.com/negue/meme-box/issues
* Star it :)

[`Getting started with Development`](README_DEV.md)

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table>
 <tbody>
 <tr>
 <td align="center"><a href="http://www.twitch.tv/littleheroesspark"><img src="https://avatars0.githubusercontent.com/u/1301564?v=4?s=100" width="100px;" alt="Aaron Rackley"/> Aaron Rackley</a> <a href="https://github.com/negue/meme-box/commits?author=ageddesi" title="Code">💻</a></td>
 <td align="center"><a href="http://twitch.tv/whitep4nth3r"><img src="https://avatars0.githubusercontent.com/u/52798353?v=4?s=100" width="100px;" alt="Salma @whitep4nth3r"/> Salma @whitep4nth3r</a> <a href="https://github.com/negue/meme-box/commits?author=whitep4nth3r" title="Code">💻</a> <a href="#ideas-whitep4nth3r" title="Ideas, Planning, & Feedback">🤔</a> <a href="#design-whitep4nth3r" title="Design">🎨</a></td>
 <td align="center"><a href="https://twitch.tv/gacbl"><img src="https://avatars0.githubusercontent.com/u/2153382?v=4?s=100" width="100px;" alt="Igor Ilic"/> Igor Ilic</a> <a href="https://github.com/negue/meme-box/issues?q=author%3Agigili" title="Bug reports">🐛</a> <a href="#ideas-gigili" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/negue/meme-box/commits?author=gigili" title="Code">💻</a> <a href="https://github.com/negue/meme-box/commits?author=gigili" title="Documentation">📖</a></td>
 <td align="center"><a href="https://github.com/CrypticEngima"><img src="https://avatars0.githubusercontent.com/u/30286773?v=4?s=100" width="100px;" alt="CrypticEngima"/> CrypticEngima</a> <a href="#design-CrypticEngima" title="Design">🎨</a></td>
 <td align="center"><a href="https://github.com/owehmer"><img src="https://avatars.githubusercontent.com/u/45573843?v=4?s=100" width="100px;" alt="Oliver"/> Oliver</a> <a href="https://github.com/negue/meme-box/issues?q=author%3Aowehmer" title="Bug reports">🐛</a> <a href="https://github.com/negue/meme-box/commits?author=owehmer" title="Code">💻</a></td>
 <td align="center"><a href="https://github.com/jonathanbucci"><img src="https://avatars.githubusercontent.com/u/29556823?v=4?s=100" width="100px;" alt="jonathanbucci"/> jonathanbucci</a> <a href="https://github.com/negue/meme-box/commits?author=jonathanbucci" title="Documentation">📖</a></td>
 <td align="center"><a href="https://www.linkedin.com/in/divs/"><img src="https://avatars.githubusercontent.com/u/55018955?v=4?s=100" width="100px;" alt="Divyanshu Singh"/> Divyanshu Singh</a> <a href="https://github.com/negue/meme-box/commits?author=divshacker" title="Code">💻</a></td>
 </tr>
 <tr>
 <td align="center"><a href="https://brandonroberts.dev"><img src="https://avatars.githubusercontent.com/u/42211?v=4?s=100" width="100px;" alt="Brandon"/> Brandon</a> <a href="https://github.com/negue/meme-box/commits?author=brandonroberts" title="Code">💻</a></td>
 <td align="center"><a href="https://www.linkedin.com/in/chirag-mahawar/"><img src="https://avatars.githubusercontent.com/u/34866279?v=4?s=100" width="100px;" alt="Chirag Mahawar"/> Chirag Mahawar</a> <a href="https://github.com/negue/meme-box/commits?author=chiragmahawar7" title="Code">💻</a></td>
 <td align="center"><a href="https://varunkhalate.me/"><img src="https://avatars.githubusercontent.com/u/68511458?v=4?s=100" width="100px;" alt="Varun Khalate"/> Varun Khalate</a> <a href="https://github.com/negue/meme-box/commits?author=khalatevarun" title="Code">💻</a></td>
 <td align="center"><a href="https://home.dnaka91.rocks"><img src="https://avatars.githubusercontent.com/u/36804488?v=4?s=100" width="100px;" alt="Dominik Nakamura"/> Dominik Nakamura</a> <a href="https://github.com/negue/meme-box/commits?author=dnaka91" title="Code">💻</a> <a href="https://github.com/negue/meme-box/commits?author=dnaka91" title="Documentation">📖</a> <a href="#platform-dnaka91" title="Packaging/porting to new platform">📦</a></td>
 </tr>
 </tbody>
 <tfoot>
 
 </tfoot>
</table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

meme-box

meme-box 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

meme-box

meme-box 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README