Giter VIP home page Giter VIP logo

twitch-multitask-task-list-overlay's Introduction

Twitch Chatbot Multitask Task List Overlay


What and Why?

A TaskList Widget for Twitch TV which allows users to interact with the broadcaster's stream. Viewers can create, edit, mark as done, and delete tasks from the list. This TaskList widget is designed to help streamers and their viewers to keep track of tasks, goals, or objectives during a stream. It is easy to use, and fast to setup. The TaskList widget is designed to be used in OBS or other streaming software as a Browser Source.

APP Features ✨

  • Free to use
  • Easy setup
  • Easy to customize
  • Fast performance & super lightweight (19 kB bundle size)
  • No coding required
  • Customizable Multi-language support
  • No third-party database required
  • User features
    • user can create multiple tasks
    • user can edit tasks
    • user can mark tasks as done
    • user can delete tasks from their list
  • Supports multiple languages translations
    • EN - English
    • ES - Español
    • FR - française
    • JP - 日本語
    • UA - українська

Table of Contents

Installation Introduction

  1. Download this repo - Download this repo by clicking on the green Code button and selecting Download ZIP.

  2. Unzip the Download - Once the download is complete, unzip the downloaded file to a location on your computer where you can easily access it and remember where it is.

  3. Setup a Browser Source in OBS - Open OBS and add a new Browser Source to your scene. Name it TaskList overlay or something you can easily remember.

  4. Select the Local file checkbox - In the Browser Source settings, select Local file and then Browse to the location where you unzipped the downloaded files. Select the index.html file and click Open.

  5. Set the Width and Height - Next, in the Browser Source, set the width and height. I recommend 660px Width and 1600px Height. Adjust as needed.

  6. Done! - Select OK to save!. Read the Customization settings section to customize the MultiTask list widget and connect it to your Twitch chat.

Customization settings

Open the configs.js file and modify the following settings to customized the TaskList widget Behavior & Appearance.

IMPORTANT! — Any changes you make to the configs.js file will require you to click the Refresh Cache of Current Page button in Browser Source you just created to see the style changes you make. (see image above, #5.)

Twitch oAuth - Required

  1. Get auth token from https://twitchapps.com/tmi
  2. open configs.js file
  3. Replace OAUTHTOKEN with your token
  4. Replace CHANNEL with your channel name
  5. Replace USERNAME with your username — in most cases it is the same as your channel name.
twitch_oauth = "OAUTHTOKEN",
twitch_channel = "CHANNEL",
twitch_username = "USERNAME",

When you are done, it should look something like this:

twitch_oauth = "oauth:138kjl2a0r3dpaf93asdf",
twitch_channel = "jujococs",
twitch_username = "jujococs",

Behavior Settings

languageCode: Default = "EN"

  • "EN": English translation
  • "ES": Spanish translation
  • "FR": French translation
  • "JP": Japanese translation
  • "UA": Ukrainian translation

maxTasksPerUser: Default = 5

  • number: A value between 1 - 10.

scrollSpeed: Default = 40

  • number: A value between 1 - 100.

showUsernameColor: Default = true

  • true: will shows the user's twitch chat color
  • false: will show the color you set in the username-color style

headerFeature: Default = "timer"

Enable one will disable the others.

  • "timer": Display a timer in the header
  • "text": Display a custom text in the header
  • "commands": Display commands tips in the header
  • "tasks-only": Display only the tasks count in the header

headerCustomText: Default = "Custom Text"

HeaderFeature above must be set to "Text"

testMode: Default = false

  • false: turn OFF test mode.
  • true: turn ON test mode.

Use this to test the TaskList without affecting the real task list and visually see the style changes you make. When test mode is OFF, the TaskList will work as normal and remove any test tasks.

Styles Settings

The following settings are for styling the TaskList. Default values are provided below. If at any point you want to reset the styles to the default values you can find the default values below next to each style name.

Font Family - selection available @ https://fonts.google.com

  • headerFontFamily: "Roboto Mono"
  • cardFontFamily: "Roboto Mono"

App Styles

  • appBorderRadius: Default = "5px"
  • appPadding: Default = "8px"
  • appBackgroundImage: Default = "url(../images/transparent-image.png)"
  • appBackgroundColor: Default = "rgba(0, 0, 0, 0)"

Header Styles

  • headerDisplay: Default = "flex"
  • headerBorderRadius: Default = "6px"
  • headerMarginBottom: Default = "6px"
  • headerBackgroundColor: Default = "rgba(45, 45, 45, 0.7)"
  • headerFontSize: Default = "20px"
  • headerFontColor: Default = "#FFFFFF"
  • headerFontWeight: Default = "normal"

Card Styles

  • cardGapBetween: Default = "6px"
  • cardBorderRadius: Default = "6px"
  • cardBackgroundColor: Default = "rgba(45, 45, 45, 0.7)"

Username Styles

  • usernameFontSize: Default = "18px"
  • usernameColor: Default = "#FFFFFF"
  • usernameFontWeight: Default = "normal"

Task Styles

  • taskFontSize: Default = "16px"
  • taskFontColor: Default = "#FFFFFF"
  • taskFontWeight: Default = "normal"
  • taskDoneFontColor: Default = "#aaaaaa"
  • taskDoneFontStyle: Default = "#italic"
  • taskDoneTextDecoration: Default = "none"

Commands

Commands for Everyone

  • !task - Add task(s) (multiple tasks must be separated by a comma)

    • example: !task read ch. 3
    • example: !task prep for exam, walk dog
  • !edit - Edit a single task

    • example: !edit 1 read ch. 4
    • example: !edit 2 walk cat
  • !done - Mark task(s) as done (multiple tasks must be separated by a comma)

    • example: !done 1
    • example: !done 2, 3
  • !delete - Delete task(s) (multiple tasks must be separated by a comma)

    • example: !delete 1
    • example: !delete 2, 3
  • !check - Check your remaining tasks

    • example: !check
  • !credit - Show the credits

    • example: !credit

Commands for Broadcasters and Moderators

  • !timer - Set the focus and break timer for a session (in minutes)

    • example: !timer 60/10
    • example: !timer 90/15
  • !clearlist - Clear all tasks from the list

    • example: !clearlist
  • !cleardone - Clear all done tasks

    • example: !cleardone
  • !clearuser - Remove all tasks from a User (case sensitive username)

    • example: !clearuser JujocoCS

Aliases

User Commands

add task commands:

  • !task
  • !añadir (Spanish)
  • !ajouter (French)
  • !追加 (Japanese)
  • !додати (Ukrainian)

edit task commands:

  • !edit
  • !editar (Spanish)
  • !modifier (French)
  • !編集 (Japanese)
  • !редагувати (Ukrainian)

complete task commands:

  • !done
  • !hecho (Spanish)
  • !terminé (French)
  • !完了 (Japanese)
  • !готово (Ukrainian)

delete task commands:

  • !delete
  • !eliminar (Spanish)
  • !supprimer (French)
  • !削除 (Japanese)
  • !видалити (Ukrainian)

check commands:

  • !check
  • !comprobar (Spanish)
  • !vérifier (French)
  • !チェック (Japanese)
  • !перевірити (Ukrainian)

help commands:

  • !help
  • !ayuda (Spanish)
  • !aide (French)
  • !ヘルプ (Japanese)
  • !допомога (Ukrainian)

extra commands:

  • !credit
  • !crédito (Spanish)
  • !crédit (French)
  • !クレジット (Japanese)
  • !кредит (Ukrainian)

Credits

Author: @JujocoCS

twitch-multitask-task-list-overlay's People

Contributors

alexvarha avatar jujoco avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

twitch-multitask-task-list-overlay's Issues

Customization bug

JavaScript error message for configs:
Line: 11
Char: 2
Error: Expected identifier, string or number
Code: 800A0404
Source: Microsoft JScript compilation error

1 line task clipping

As a streamer I'd like to have a setting allowing me to chose whether to clip tasks taking longer than 1 line, to better control how my cards and tasks look for the viewers

iCTXui8z08

bot should reply with string, not with task id

as a user I'd like to see the content of the task when the bot responds to me in chat, citing the content of the task instead of its number (the way other bots handle task management)

chrome_mhXBUceICL

Feature Request: Add pomodoros command to application

It would be nice to add number of pomodoros to the app.

Command could be like !pomo 4
And then when setting timer (or if timer is already set) it would not stop after the break ended but show the number of pomos and the current pomo and automatically start next pomo when break is over.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.