Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 564 Commits
.github/workflows		.github/workflows
.storybook		.storybook
assets		assets
cypress		cypress
memebox-streamdeck		memebox-streamdeck
projects		projects
scripts		scripts
server		server
src-tauri		src-tauri
src		src
tutorials		tutorials
.all-contributorsrc		.all-contributorsrc
.deepsource.toml		.deepsource.toml
.editorconfig		.editorconfig
.eslintignore		.eslintignore
.eslintrc-angular-specific.json		.eslintrc-angular-specific.json
.eslintrc-shared-libs.json		.eslintrc-shared-libs.json
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
API_ENDPOINTS.md		API_ENDPOINTS.md
BUILD.md		BUILD.md
CHANGELOG.md		CHANGELOG.md
LICENSE.md		LICENSE.md
README.md		README.md
README_DEV.md		README_DEV.md
REFACTOR_THIS.md		REFACTOR_THIS.md
ROADMAP.md		ROADMAP.md
STACK.md		STACK.md
WebSocket-Actions.md		WebSocket-Actions.md
angular.json		angular.json
angular.webpack.cjs		angular.webpack.cjs
cypress.json		cypress.json
decorate-angular-cli.js		decorate-angular-cli.js
electron-builder.json		electron-builder.json
electron-shell.ts		electron-shell.ts
jest.config.js		jest.config.js
jest.preset.js		jest.preset.js
ngsw-config.json		ngsw-config.json
nx.json		nx.json
package-lock.json		package-lock.json
package.json		package.json
preload.ts		preload.ts
setup-jest.ts		setup-jest.ts
test-config.helper.ts		test-config.helper.ts
transloco.config.js		transloco.config.js
tsconfig-electron.json		tsconfig-electron.json
tsconfig.base.json		tsconfig.base.json
tsconfig.spec.json		tsconfig.spec.json
tsconfig.worker.json		tsconfig.worker.json
version_update.json		version_update.json

Repository files navigation

Meme-Box |Getting Started |How to contribute

A complete management app forimage / audio / video / iframe / widgets "media" to be used inside OBS. Or trigger other custom actions.

Media Setup Example + Mobile View	Setup a Twitch-Trigger

Installation

Pre-built binaries

Download latest release! (currently a bit ouf of date, new release soon) -latest nightly Builds

From source

If you would like to build MemeBox from source, have a look at our dedicatedBUILD.md.

From AUR

If you're an Arch Linux user, you can install directly from theAUR, using one of theAUR helpers.

For example, withparu:

paru -S memebox

Working Features

Show Media	Screens (in OBS)	Triggers
Images	Animations on show / hideVisibility: Play (on a trigger) Toggle (per trigger) Always Visible Custom Position per Media / Screen: Fullscreen Fixed (on a position) Centered Random Misc: Custom CSS per Media / Screen drag&drop for better position items rotate/size/warp items	✅`Streamdeck Plugin` ✅`Deckboard Plugin` ✅ Timers ✅ Mobile View ✅ Twitch Events Bits Channel Points Message Raid User Ban Subscription Gift Sub
Videos
Iframes
Widgets
Play Audio
Actions
`Trigger multiple / random Media`
Scripts (Action)
Trigger other Actions with custom logic/timeouts/overrides Trigger OBS functions Write to Twitch Chat
Permanent Script
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`
API for Developers
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/`

Getting Started

Note: These are the currentGetting Started / Tutorials for this branch.
To see the updatedGetting Started / Tutorials from the released version -click here!

Installation and Getting Started

Advanced:

Roadmap

2023.1 (maybe 2024.1, depending how long it takes)

Main Feature:Refactor Trigger System / Config
- Easier way to add more types of triggers
- Also adds the command blocks per trigger (easier way to just "do" stuff)

Dependencies for that: ^

#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

How to help / contribute?

Improve Docs / Translations
Find bugs
Suggestions to makethings (UI, Text, Docs etc) more understandable
Help fix bugs / improve features
- Good First Issues
- Open for Contribution
- Developers Sanity
- or all other Issue, in case I missed to label them:https://github.com/negue/meme-box/issues
Star it :)

Getting started with Development

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Aaron Rackley} 💻	_{Salma @whitep4nth3r} 💻🤔🎨	_{Igor Ilic} 🐛🤔💻📖	_{CrypticEngima} 🎨	_Oliver 🐛💻	_{jonathanbucci} 📖	_{Divyanshu Singh} 💻
_Brandon 💻	_{Chirag Mahawar} 💻	_{Varun Khalate} 💻	_{Dominik Nakamura} 💻📖📦