{"id":23082424,"url":"https://github.com/dirvann/video-conference-stitcher","last_synced_at":"2025-10-17T13:57:18.189Z","repository":{"id":47823338,"uuid":"287307399","full_name":"Dirvann/video-conference-stitcher","owner":"Dirvann","description":"This package makes it possible to combine separately recorder media files from a video conference call into a single file.","archived":false,"fork":false,"pushed_at":"2023-09-21T01:44:14.000Z","size":6982,"stargazers_count":24,"open_issues_count":4,"forks_count":10,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-24T14:35:03.137Z","etag":null,"topics":["ffmpeg","recording","video-files","webrtc"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Dirvann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2020-08-13T14:51:44.000Z","updated_at":"2025-07-01T03:21:59.000Z","dependencies_parsed_at":"2024-11-15T20:43:48.836Z","dependency_job_id":"2d8594e9-4b7e-48c2-bb61-f63cd3a065cc","html_url":"https://github.com/Dirvann/video-conference-stitcher","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"31d61457ba523009278112864c42fe0c3abbb36e"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Dirvann/video-conference-stitcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dirvann%2Fvideo-conference-stitcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dirvann%2Fvideo-conference-stitcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dirvann%2Fvideo-conference-stitcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dirvann%2Fvideo-conference-stitcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dirvann","download_url":"https://codeload.github.com/Dirvann/video-conference-stitcher/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dirvann%2Fvideo-conference-stitcher/sbom","scorecard":{"id":40948,"data":{"date":"2025-08-11","repo":{"name":"github.com/Dirvann/video-conference-stitcher","commit":"31d61457ba523009278112864c42fe0c3abbb36e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.4,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 1/19 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-14T21:31:06.725Z","repository_id":47823338,"created_at":"2025-08-14T21:31:06.725Z","updated_at":"2025-08-14T21:31:06.725Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272280330,"owners_count":24906114,"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","status":"online","status_checked_at":"2025-08-27T02:00:09.397Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["ffmpeg","recording","video-files","webrtc"],"created_at":"2024-12-16T14:52:21.037Z","updated_at":"2025-10-17T13:57:13.146Z","avatar_url":"https://github.com/Dirvann.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Video Conference Stitcher\n\nCombine separately recorded recordings from a video conference into a single video file.\n\n## How it works\n\nThis project is intended to combine separately recorded videos from a live video conference into a single recording. All this while having control of how the layout is. The input videos can start any time in the conference and the layout will change dynamically. \n\nThe minimal information needed is:\n\n- start time of the recording (relative to the beginning of the call)\n- file of the recording (audio and video may or may not be separate)\n\n\n![Alt text](docs/images/combining-example.jpg?raw=true \"Encoding example\")\n\n## Requirements\n\n- [ffmpeg](https://ffmpeg.org/download.html)\n- linux system (windows not supported at this time, [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10) is a good option for running on windows)\n\n## Installation\n\nInstall with npm with the following command:\n\n`npm install --save video-conference-stitcher`\n\n## Getting started\n\n### Run the example\n\nTo run the example run the following command in the main folder:\n\n`npm run example`\n\n### Example script\n\n```typescript\nconst path = require('path')\nconst fs = require('fs')\n\n// import the classes\nconst {User, Layouts, Sequence, Media} = require('video-conference-stitcher')\nconst {PresenterLayout, GridLayout, MosaicLayout} = Layouts\n\n\n// variable for folders to get the videos from\nconst videoFolder = path.join(__dirname, 'videos')\nfs.mkdir(videoFolder)\n\n// creating a lists of media (audio+video / audio / video) for each user\nconst userMedia1:Media[] = [\n  new Media(path.join(videoFolder,'vid1.mp4'), 0, true, true),\n]\nconst userMedia2:Media[] = [\n  new Media(path.join(videoFolder,'vid2.mp4'), 2000, true, true)\n]\n\n// Create users with their id, name and media files\nconst users:User[] =[\n  new User('user1', userMedia1, 'KEVIN'),\n  new User('user2', userMedia2, 'JEFF')\n]\n\n// Select a layout to use\nconst videoLayout:VideoLayout = new PresenterLayout()\n\n// Destination file\nconst outputMedia: Media = new Media(path.join(videoFolder, 'basicOutput.mp4'), -1, true, true)\n\n// encoding options\nconst encodingOptions = {\n  crf: 20,\n  loglevel: 'verbose',\n  size:{\n    w: 1280,\n    h: 720\n  }\n}\n\n// Create a sequence with given settings\nconst sequence = new Sequence(0, users,outputMedia, videoLayout, encodingOptions)\n\n// Encode the sequence, now the output file with the generated combined video is generated\nsequence.encode().then(comm =\u003e {\n  console.log(comm)\n})\n```\n\n\n\n## Documentation\n\n### Classes\n\n### Media(path: string, startTime:number, hasVideo:boolean, hasAudio:boolean)\n\nDefines a single video / audio file on the file system. The file can contain audio and video at the same time or separately.\n\n##### Parameters\n\n- **path**: Path to the media file as string.\n- **startTime**: Relative time when the media starts in ms. The time is the time elapsed from the start of the video conference (which is 0ms).\n- **hasVideo**: If the media file contains a video stream.\n- **hasAudio**: If the media file contains an audio stream.\n\n##### Usage\n\n```js\nconst {Media} = require('video-conference-stitcher')\nconst mediaObject = new Media('/home/user/vid.mp4', 2000, true, true)\n```\n\n\u0026nbsp;\n\u0026nbsp;\n\n### User(id:string|number,media:Media[], name?:string|undefined) \n\nA user in the video conference. May have multiple streams.\n\n##### Parameters\n\n- **id**: string / number with the id of the user.\n- **media**: List of media objects for the user.\n- **name**(optional): Display name of the user.\n\n##### Usage\n\n```js\nconst {User Media} = require('video-conference-stitcher')\n\nconst mediaList = [new Media(...), new Media(...)]\n                                          \nconst user = new User('user123', mediaList, 'Bob')\nOR \nconst user = new User('user123', mediaList)\n```\n\n\u0026nbsp;\n\u0026nbsp;\n\n### Layouts\n\nObjects that can be used for different output layouts or in other words change the arrangement of the separate video streams on the screen.\n\nAvailable:\n\n- Layouts.GridLayout\n- Layouts.PresenterLayout\n- Layouts.MosaicLayout\n\n##### Usage\n\n```js\nconst {Layouts} = require('video-conference-stitcher')\nconst videoLayout = new Layouts.GridLayout()\nconst seq = new Sequence(.., ..,.., videoLayout, ..)\n```\n\n\u0026nbsp;\n\u0026nbsp;\n\n### Sequence (users:User[], outputVideo:Media, layout:VideoLayout, encOpt?: EncodingOptions)\n\n##### Parameters\n\n- **users**(Users[]): List of user objects to be encoded.\n- **outputVideo**: Media object for the output file.\n- **layout**: Layout of the combined videos.\n- **encOpt**(optional): Extra options for encoding.\n\n##### Functions\n\n- **encode()**: Encodes the separate files into a single file with the given commands.\n- **generateCommand()**: Returns the ffmpeg command that will run as a string.\n\n##### Usage\n\n```js\nconst {Sequence, User, Layouts} = require('video-conference-stitcher')\n\nconst encodingOptions = {...}\nconst videoLayout = new GridLayout() // other layouts possible\nconst outputMedia = new Media(...)\nconst users = [new User(...), new User(...)]\n                                       \nconst seq = new Sequence(users,outputMedia, videoLayout, encodingOptions)\nOR\nconst seq = new Sequence(users,outputMedia, videoLayout)\n\n```\n\n\u0026nbsp;\n\n### Types\n\n### EncodingOptions\n\nObject containing encoding options for encoding the sequence.\n\n##### Properties\n\n- **crf**(optional): Quality parameter for encoding, more documentation [here](https://trac.ffmpeg.org/wiki/Encode/H.264).\n  - default: 22\n  - type: number\n- **bitrate**(optional): Setting output bitrate. Will be overridden if crf is also defined.\n  - type: string\n- **size**: Resolution of the output video.\n  - type: object   -\u003e {w: number, h: number}\n- **loglevel**(optional): Log level for ffmpeg. More documentation for loglevel in [ffmpeg documentation](https://ffmpeg.org/ffmpeg.html#toc-Generic-options)\n  - options: number| 'quiet' | 'panic' | 'fatal' | 'error' | 'warning' | 'info' | 'verbose' | 'debug' | 'trace'\n\n##### Usage\n\n```js\nconst encodingOptions = {\n    crf: 20,\n    size: {\n        w: 1280,\n        h: 720\n    },\n    loglevel: 'quiet'\n}\n\n--------------------------\nconst encodingOptions = {\n    bitrate: '2000M',\n    size: {\n        w: 1000,\n        h: 500\n    }\n}\n```\n\n\n\n## Implementation in [mediasoup](https://mediasoup.org)\n\nA call can be recorded by connecting mediasoup to a recorder like **ffmpeg** or **gstreamer**. There is a good example for recording in **[THIS PROJECT](https://github.com/ethand91/mediasoup3-record-demo)**.\n\nThe files should be saved with the timestamp of when each individual stream has started recording.\n\nThese separate files can be used to combined with the video-conference-stitcher tool.\n\n\n\n## TODO\n\n- [x] link user to video audio file\n- [x] user with audio, no video, but active speaker -\u003e placeholder\n- [ ] implement custom user priority map\n- [ ] video cover option for layout boxes (now only fit )\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirvann%2Fvideo-conference-stitcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdirvann%2Fvideo-conference-stitcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirvann%2Fvideo-conference-stitcher/lists"}