{"id":20762035,"url":"https://github.com/donkeyclip/motorcortex-scroller","last_synced_at":"2025-04-30T06:28:39.767Z","repository":{"id":37272255,"uuid":"224644550","full_name":"donkeyclip/motorcortex-scroller","owner":"donkeyclip","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-19T20:28:46.000Z","size":27313,"stargazers_count":0,"open_issues_count":16,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-19T22:04:21.514Z","etag":null,"topics":["motorcortex-player","motorcortex-plugin"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/donkeyclip.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-28T12:04:33.000Z","updated_at":"2022-04-01T08:49:13.000Z","dependencies_parsed_at":"2023-09-24T09:36:31.775Z","dependency_job_id":"8f0aa88f-28f3-4dec-8d69-9a90cd0ad330","html_url":"https://github.com/donkeyclip/motorcortex-scroller","commit_stats":{"total_commits":1102,"total_committers":15,"mean_commits":73.46666666666667,"dds":0.4900181488203267,"last_synced_commit":"37278835922ac9ecdd55a9398c57e717c8db8644"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkeyclip%2Fmotorcortex-scroller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkeyclip%2Fmotorcortex-scroller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkeyclip%2Fmotorcortex-scroller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkeyclip%2Fmotorcortex-scroller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/donkeyclip","download_url":"https://codeload.github.com/donkeyclip/motorcortex-scroller/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251653559,"owners_count":21622150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["motorcortex-player","motorcortex-plugin"],"created_at":"2024-11-17T10:28:46.797Z","updated_at":"2025-04-30T06:28:39.696Z","avatar_url":"https://github.com/donkeyclip.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MotorCortex-Scroller\n\n**Table of Contents**\n\n- [MotorCortex-Scroller](#motorcortex-scroller)\n  - [Demo](#demo)\n- [Intro / Features](#intro--features)\n- [Getting Started](#getting-started)\n  - [Installation](#installation)\n  - [Importing](#importing)\n- [Creating WheelPlayer](#creating-wheelplayer)\n  - [Free Mode](#free-mode)\n  - [Chapters Mode](#chapters-mode)\n- [Contributing](#contributing)\n- [License](#license)\n- [Sponsored by](#sponsored-by)\n\n## Demo\n[Check it out here](https://donkeyclip.github.io/motorcortex-scroller/demo/)\n\n- On mobile: Swipe left or right to move between chapters\n- On desktop devices: use your mouse wheel\n  \n\n# Intro / Features\n\nMotorCortex-Scroller (WheelPlayer) controls your MotorCortex Clips' execution via mouse wheel or (touch) swipe.\nThe Player can either operate on \"free\" mode where the more you scroll (or swipe) the more it moves forward or backward or on the \"chapters\" mode where chapters can be defined.\nOn \"chapters\" mode the developer can define distinct chapters (by providing their milliseconds) and at the end of each swipe or scroll the Clip will move either forward or backward (depending on the direction) to reach the closest chapter.\n\nThis plugin exposes two types of WheelPlayers:\n- Free mode\n- Chapters mode\n\n# Getting Started\n## Installation\n```bash\n$ npm install --save @donkeyclip/motorcortex-scroller\n# OR\n$ yarn add @donkeyclip/motorcortex-scroller\n```\n## Importing\n```javascript\nconst WheelPlayer = import('@donkeyclip/motorcortex-scroller');\n```\n# Creating WheelPlayer\n\nYou just instantiate a new Player object passing options:\n## Free Mode\n```javascript\nconst Player = new WheelPlayer({\n    clip: myClip\n});\n```\n\n## Chapters Mode\n```javascript\nconst Player = new WheelPlayer({\n    clip: myClip,\n    speed: 5,\n    mode: 'chapters',\n    chapters: [{\n            millisecond: 2000,\n            name: 'chapter 1'\n        },\n        {\n            millisecond: 4000,\n            name: 'chapter 2'\n        }\n    ],\n    transitionSpeed: 2,\n    swipeAxis: 'horizontal',\n    scrollbar: {\n        color: 'pink',\n        position: 'top'\n    }\n});\n```\n\n## Options\n\n| Name | Description |\n| ------------- | ------------- |\n| mode | (optional, default = \"free\"). Either \"free\" or \"chapters\" |\n| wheelSpeed | (optional, default = 5). Valid input is any number from 1 to 10. It defines the speed the Clip will seek forward or backward when scrolling or swiping |\n| chapters | (valid only on \"chapters\" mode). It expects an array of objects each of which defines a chapter. Chapters are provided in the form: {name: \"\u003cthe name of the chapter\u003e\", millisecond: \u003cmillisecond\u003e} |\n| transitionSpeed | (valid only on \"chapters\" mode, optional, default = 1). Valid input is any number greater than 0. On scroll (or swipe) end the Clip will transition to the next (or previous) chapter. The speed of the transition is in real time (1:1). If provided, the transitionSpeed will affect the transition speed (e.g. setting it to 2 it will transition two times faster, setting it to 0.5 two times slower etc) |\n| swipeAxis | (optional, default = \"vertical\"). It defines the active axis of swipe. Default is vertical meaning the user will have to swipe upwards or downwards in order to control Clip's execution. If is set to \"horizontal\" the user will need to swipe to left or right |\n| progressBar | (optional, default is {display: true, position: 'right', color: 'purple'}). Progress bar visualises the progress of the Clip's execution. By default is positioned on the right and it's visible |\n  \n# Contributing \n\nIn general, we follow the \"fork-and-pull\" Git workflow, so if you want to submit patches and additions you should follow the next steps:\n1.\t**Fork** the repo on GitHub\n2.\t**Clone** the project to your own machine\n3.\t**Commit** changes to your own branch\n4.\t**Push** your work back up to your fork\n5.\tSubmit a **Pull request** so that we can review your changes\n\n# License\n\n[MIT License](https://opensource.org/licenses/MIT)\n\n# Sponsored by\n[\u003cimg src=\"https://presskit.donkeyclip.com/logos/donkey%20clip%20logo.svg\" width=250\u003e\u003c/img\u003e](https://donkeyclip.com)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonkeyclip%2Fmotorcortex-scroller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdonkeyclip%2Fmotorcortex-scroller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonkeyclip%2Fmotorcortex-scroller/lists"}