wranglebot

WrangleBot - Media Asset Management Platform

WrangleBot is an open source media asset management platform engine.

🧰 Features

WrangleBot offers a variety of features to make asset management easier and more efficient:

• Ingest: Copy & Verify
  • ingest entire volumes or individual folders to your media libraries
  • auto scan, extract meta data, generate unique hash using xxHash algorithms
  • extract thumbnails from video footage for cloud preview
• Manage Metadata
  • edit and view metadata in advanced meta data editor
  • extract and scrub through thumbnails
• Library Management
  • create bins to manage media into categories and tags
  • import new files from "watched" bins
  • app automatically relocates and connects to storage devices
• Export and Transcode
  • transcode media to ProRes, H264 and DNxHD up to 4K
  • export with LUTs
• Open Source
  • open NodeJS engine and browser client
  • written in NodeJS with Typescript
  • Javascript API, that uses chained commands and is easy to use without knowledge of the underlying code
  • fully controllable via REST API
  • currently supports both Intel x64 and AMD64, as well as Apple Silicon

Dependencies

To build WrangleBot, you will need to have Node.js installed on your computer. WrangleBot requires Python >=3.12 for node-gyp to compile binaries for the node modules.

You may need to use the --python flag when installing the package:

npm i --python=python3.12

Replace the version number of Python with the version you have installed on your system, i.e. 3.13

📦 Install as Package

npm install wranglebot

📦 Install for Development

npm install

After that, run npm run build to build the application.

Getting Started

Testing

Clone this repository and run npm install to install the dependencies.

The folder test contains a test environment that can be used to boot up an instance of WrangleBot.

⚠️ You will require a .env to run the test environment:

APP_DATA_LOCATION="<YOUR_APP_DATA_LOCATION>" # choose your app data location, i.e. "/Users/username/.wranglebot"
LOCAL_DATABASE_TOKEN="<YOUR_DATABASE>" # choose your database token to connect to the database, i.e. "my_database"
SERVER_PORT="3200" # choose your server port, i.e. "3200"
DEBUG_NOTIFICATIONS="false" #show notifications in console (true/false)

# Optional, required to use the email notfications and password reset functions
SMTP_HOST="<YOUR_EMAIL_HOST>"
SMTP_PORT="<YOUR_EMAIL_SMTP_PORT>" # 465 for SSL, 587 for TLS
SMTP_USER="<YOUR_EMAIL_USERNAME>"
SMTP_PASS="<YOUR_EMAIL_PASS>"

Run npm run test to run the test environment.

Starting WrangleBot

To use WrangleBot in your own package, install with npm install wranglebot and use the .open() method:

import wranglebot from "wranglebot"

wranglebot.open({
  app_data_location: "<APP_DATA_LOCATION>",
  vault: {
    token: "<LOCAL_DATABASE_TOKEN>"
  },
  port: "<SERVER_PORT>",
  //optional
  mail: {
    host: "<SMTP_HOST>",
    port: "<SMTP_PORT>",
    auth: {
      user: "<SMTP_USER>",
      pass: "<SMTP_PASS>",
    },
  },
})

Default Login

The default login is admin with the password admin.

Documentation

📑 REST API Documentation

(Postman) REST API with Examples

📑 NodeJS Documentation

(GitBook) NodeJS API & Model Documentation

💬 Discord

Join our Discord for live support.

👥 Contributing

We welcome contributions to WrangleBot! Please join us on our Discord to discuss how you can help. We are always looking for new contributors to help us build the best media asset management tool possible and want to make it as easy as possible for you to get involved.

📜 License

WrangleBot is released under the GPL-3.0 License. For more information, please view the license. You must publish all changes and modifications to the source code under the same license. We encourage you to contribute to the project and make it better for everyone.