New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details → →
Socket
Book a DemoSign in
Socket
Book a DemoSign in

obsdev

Package Overview
Dependencies
Maintainers
1
Versions
12
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

obsdev

Automate use of OBS recordings via command line to help document development workflows with audio/video

latest
Source
npmnpm
Version
1.1.7
Version published
Weekly downloads
2
-77.78%
Maintainers
1
Weekly downloads
 
Created
Source

obsdev

oclif Version Downloads/week

Automate use of OBS recordings to help document development workflows with audio/video

Use obsdev record $recordingName within a git repo to start recording and then stop the recording via OBS or obsdev stop-record.

What is obsdev?

obsdev is a command line utility that helps developers use OBS to record videos as they work and easily organize where the recordings are stored based on the current git branch.

It also takes advantage of oclif plugins to allow developers to add plugins to further process saved recordings. Check out obsdev-jira-plugin which uploads saved recordings to JIRA tickets automatically.

Videos are a crucial communication mechanism for teams, especially remote teams in agile development. They can cut down on meetings, enable clearer async communication, and serve as work documentation (when you are asked by your colleagues if X feature really worked when you tested and merged it, you can back it up with video proof rather than memory).

In a manual flow, you have to:

  • go to OBS
  • start recording
  • stop recording
  • go manually find recording in filesystem
  • recording is generated with hard to read filename (its date recording was made), and its thrown into root OBS recording output directory (~/Users/me/Movies)
  • optionally choose to rename and move recording or keep in one big directory
  • manually upload recording to another platform (JIRA, OneDrive, GitLab)

In obsdev flow, you have to:

  • be in git repo checked out on a branch
  • run obsdev record $recordingName
  • stop recording (use ctrl+c, OBS directly, or obsdev stop-record)
  • filesystem window (Finder) automatically opens to file for easy replay
  • recording is generated with provided $recordingName in a directory named after your branch within the root OBS recording output path that is configured
    • Ex path: ~/Users/me/Movies/BRANCH-1234/demo.mp4
  • Utilize plugins to programmatically upload videos to another platform

Requirements

Environment Variables

  • OBS_WS_IP : optional. defaults to 127.0.0.1
  • OBS_WS_PORT: optional. defaults to 4455

Limitations

  • Not tested yet on Windows
  • If tool errors after setting output path for recording, it will require manual fixing back to root path you want to use. Need to find a programmatic fix for this

Usage

$ npm install -g obsdev
$ obsdev COMMAND
running command...
$ obsdev (--version)
obsdev/1.1.7 linux-x64 node-v24.8.0
$ obsdev --help [COMMAND]
USAGE
  $ obsdev COMMAND
...

Commands

obsdev help [COMMAND]

Display help for obsdev.

USAGE
  $ obsdev help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for obsdev.

See code: @oclif/plugin-help

obsdev plugins

List installed plugins.

USAGE
  $ obsdev plugins [--json] [--core]

FLAGS
  --core  Show core plugins.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List installed plugins.

EXAMPLES
  $ obsdev plugins

See code: @oclif/plugin-plugins

obsdev plugins add PLUGIN

Installs a plugin into obsdev.

USAGE
  $ obsdev plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]

ARGUMENTS
  PLUGIN...  Plugin to install.

FLAGS
  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
  -h, --help     Show CLI help.
  -s, --silent   Silences npm output.
  -v, --verbose  Show verbose npm output.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Installs a plugin into obsdev.

  Uses npm to install plugins.

  Installation of a user-installed plugin will override a core plugin.

  Use the OBSDEV_NPM_LOG_LEVEL environment variable to set the npm loglevel.
  Use the OBSDEV_NPM_REGISTRY environment variable to set the npm registry.

ALIASES
  $ obsdev plugins add

EXAMPLES
  Install a plugin from npm registry.

    $ obsdev plugins add myplugin

  Install a plugin from a github url.

    $ obsdev plugins add https://github.com/someuser/someplugin

  Install a plugin from a github slug.

    $ obsdev plugins add someuser/someplugin

obsdev plugins:inspect PLUGIN...

Displays installation properties of a plugin.

USAGE
  $ obsdev plugins inspect PLUGIN...

ARGUMENTS
  PLUGIN...  [default: .] Plugin to inspect.

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Displays installation properties of a plugin.

EXAMPLES
  $ obsdev plugins inspect myplugin

See code: @oclif/plugin-plugins

obsdev plugins install PLUGIN

Installs a plugin into obsdev.

USAGE
  $ obsdev plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]

ARGUMENTS
  PLUGIN...  Plugin to install.

FLAGS
  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
  -h, --help     Show CLI help.
  -s, --silent   Silences npm output.
  -v, --verbose  Show verbose npm output.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Installs a plugin into obsdev.

  Uses npm to install plugins.

  Installation of a user-installed plugin will override a core plugin.

  Use the OBSDEV_NPM_LOG_LEVEL environment variable to set the npm loglevel.
  Use the OBSDEV_NPM_REGISTRY environment variable to set the npm registry.

ALIASES
  $ obsdev plugins add

EXAMPLES
  Install a plugin from npm registry.

    $ obsdev plugins install myplugin

  Install a plugin from a github url.

    $ obsdev plugins install https://github.com/someuser/someplugin

  Install a plugin from a github slug.

    $ obsdev plugins install someuser/someplugin

See code: @oclif/plugin-plugins

obsdev plugins link PATH

Links a plugin into the CLI for development.

USAGE
  $ obsdev plugins link PATH [-h] [--install] [-v]

ARGUMENTS
  PATH  [default: .] path to plugin

FLAGS
  -h, --help          Show CLI help.
  -v, --verbose
      --[no-]install  Install dependencies after linking the plugin.

DESCRIPTION
  Links a plugin into the CLI for development.

  Installation of a linked plugin will override a user-installed or core plugin.

  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
  command will override the user-installed or core plugin implementation. This is useful for development work.


EXAMPLES
  $ obsdev plugins link myplugin

See code: @oclif/plugin-plugins

obsdev plugins remove [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ obsdev plugins remove [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ obsdev plugins unlink
  $ obsdev plugins remove

EXAMPLES
  $ obsdev plugins remove myplugin

obsdev plugins reset

Remove all user-installed and linked plugins.

USAGE
  $ obsdev plugins reset [--hard] [--reinstall]

FLAGS
  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
  --reinstall  Reinstall all plugins after uninstalling.

See code: @oclif/plugin-plugins

obsdev plugins uninstall [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ obsdev plugins uninstall [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ obsdev plugins unlink
  $ obsdev plugins remove

EXAMPLES
  $ obsdev plugins uninstall myplugin

See code: @oclif/plugin-plugins

obsdev plugins unlink [PLUGIN]

Removes a plugin from the CLI.

USAGE
  $ obsdev plugins unlink [PLUGIN...] [-h] [-v]

ARGUMENTS
  PLUGIN...  plugin to uninstall

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Removes a plugin from the CLI.

ALIASES
  $ obsdev plugins unlink
  $ obsdev plugins remove

EXAMPLES
  $ obsdev plugins unlink myplugin

obsdev plugins update

Update installed plugins.

USAGE
  $ obsdev plugins update [-h] [-v]

FLAGS
  -h, --help     Show CLI help.
  -v, --verbose

DESCRIPTION
  Update installed plugins.

See code: @oclif/plugin-plugins

obsdev record [FILENAME]

Start an OBS recording

USAGE
  $ obsdev record [FILENAME] [-d]

ARGUMENTS
  FILENAME  filename for saved recording with no extension

FLAGS
  -d, --dryRun  Print what would happen but take no action

DESCRIPTION
  Start an OBS recording

EXAMPLES
  $ obsdev record -d demo-1

See code: src/commands/record.ts

obsdev stop-record

Stop an OBS recording

USAGE
  $ obsdev stop-record

DESCRIPTION
  Stop an OBS recording

EXAMPLES
  $ obsdev stop-record

See code: src/commands/stop-record.ts

obsdev version

USAGE
  $ obsdev version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version

Hooks

The following are hooks that obsdev emits for plugins to tap into

  • videoSaved
    • dryRun : boolean
    • path : string - this is the path the video was saved to

Keywords

obs
developer
recording

FAQs

Package last updated on 18 Sep 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

Attackers Are Hunting High-Impact Node.js Maintainers in a Coordinated Social Engineering Campaign

Security News

Attackers Are Hunting High-Impact Node.js Maintainers in a Coordinated Social Engineering Campaign

Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.

By Sarah Gooding  -  Apr 03, 2026