tapehq / tape-cli

CLI tool to collaborate better during mobile development, for iOS & tvOS simulators and Android emulators and devices. Share screenshots, screen recordings as video or GIFs. Use with https://tape.sh or bring your own bucket!

tape-cli

Collaborate better during mobile development, for iOS & tvOS simulators and Android emulators and devices. Share screenshots, screen recordings as video or GIFs. Use with https://www.tape.sh/ or bring your own bucket!

---

---

• tape-cli
• Installation
• Usage
• Commands

---

Installation

brew install edamameldn/tap/tape-cli

or

npm install -g tape-cli

Usage

$ npm install -g tape-cli
$ tape COMMAND
running command...
$ tape (-v|--version|version)
tape-cli/0.14.0 darwin-x64 node-v14.0.0
$ tape --help [COMMAND]
USAGE
  $ tape COMMAND
...

Commands

• tape config [NAME]
• tape devices
• tape frame [INPUTFILE]
• tape gif
• tape help [COMMAND]
• tape image
• tape login
• tape upgrade
• tape video

tape config [NAME]

Configuration

USAGE
  $ tape config [NAME]

OPTIONS
  -h, --help   show CLI help
  -s, --setup
  --check
  --login

EXAMPLE
  $ tape config

See code: src/commands/config.ts

tape devices

List devices

USAGE
  $ tape devices

OPTIONS
  -c, --clear
  -h, --help   show CLI help

ALIASES
  $ tape device
  $ tape emu
  $ tape sims

EXAMPLE
  $ tape devices

See code: src/commands/devices.ts

tape frame [INPUTFILE]

Wrap an existing screenshot or video in a device frame (if available) and upload to Tape.sh

USAGE
  $ tape frame [INPUTFILE]

OPTIONS
  -d, --debug
  -h, --help                                                      show CLI help
  -l, --local=~/Documents
  --format=md|href|html|url
  --frame Select which frame to use, if there are multiple=frame
  --hq
  --nocopy Disable copying to clipboard
  --noframe Disable device frames
  --selectframe Select which frame to use, if there are multiple

ALIASES
  $ tape frame
  $ tape wrap
  $ tape upload

See code: src/commands/frame.ts

tape gif

Record iOS simulators and Android devices/emulators and output a gif file

USAGE
  $ tape gif

OPTIONS
  -d, --debug
  -h, --help                                                      show CLI help
  -l, --local=~/Documents
  --format=md|href|html|url
  --frame Select which frame to use, if there are multiple=frame
  --hq
  --nocopy Disable copying to clipboard
  --noframe Disable device frames
  --selectframe Select which frame to use, if there are multiple

ALIASES
  $ tape gif
  $ tape g

EXAMPLE
  $ tape gif [--local $OUTPUTPATH]
  🎬 Recording started. Press SPACE to save or ESC to abort.

See code: src/commands/gif.ts

tape help [COMMAND]

display help for tape

USAGE
  $ tape help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

tape image

Take screenshots of iOS/Android devices/simulators

USAGE
  $ tape image

OPTIONS
  -d, --debug
  -h, --help                                                      show CLI help
  -l, --local=~/Documents
  --format=md|href|html|url
  --frame Select which frame to use, if there are multiple=frame
  --nocopy Disable copying to clipboard
  --noframe Disable device frames
  --selectframe Select which frame to use, if there are multiple

ALIASES
  $ tape i
  $ tape screenshot
  $ tape img

EXAMPLE
  $ tape image
  🎉 Screenshot uploaded. Copied URL to clipboard 🔖 ! -> 
    https://example.com/image.png

See code: src/commands/image.ts

tape login

Log in to Tape.sh

USAGE
  $ tape login

ALIASES
  $ tape auth
  $ tape authorize

EXAMPLE
  $ tape login

See code: src/commands/login.ts

tape upgrade

Opens a direct link to upgrade your Tape.sh plan

USAGE
  $ tape upgrade

OPTIONS
  -h, --help      show CLI help
  -p, --plan=Pro  Plan name to upgrade to

See code: src/commands/upgrade.ts

tape video

Record iOS/Android devices/simulators

USAGE
  $ tape video

OPTIONS
  -d, --debug
  -g, --gif
  -h, --help                                                      show CLI help
  -l, --local=~/Documents
  --format=md|href|html|url
  --frame Select which frame to use, if there are multiple=frame
  --hq
  --nocopy Disable copying to clipboard
  --noframe Disable device frames
  --selectframe Select which frame to use, if there are multiple

ALIASES
  $ tape video
  $ tape vid
  $ tape m

EXAMPLE
  $ tape video [--hq | --gif | --local $OUTPUTPATH]
  🎬 Recording started. Press SPACE to save or ESC to abort.

See code: src/commands/video.ts

License

MIT License, read more here

by edamame studio

tape-cli's Issues

[Android] Gracefully handle unauthorized devices

FailError: Failure: 'device unauthorized.
This adb server's $ADB_VENDOR_KEYS is not set
Try 'adb kill-server' if that seems wrong.
Otherwise check for a confirmation dialog on your device.'
    at ~/Git/edamame/tape-cli/node_modules/adbkit/lib/adb/parser.js:183:29

Large file uploads fail

 📼 Processing your tape... done
 🚴🏽‍♀️ Making your gif...... ✔️
Original file size: 4.53 MB
📼  Tape output file size: 17 MB
🔗 Uploading file...... 😨 Upload failed.
 ›   Error: Request body larger than maxBodyLength limit

[Windows] - Tape videos from Android slowed down

This seems to be related to the way Android sims process the recorded video. On mac, we need to slow it down - because the raw output is quite fast.

Checklist to understand the issue better:

• Does window record emulator at normal speed?
• Does linux record emulator at normal speed?

If the double speed issue is mac only, we should apply the ffmpeg filter only on mac

M1 unsupported

Android size always greater than 10mb

Creating gifs locally on android, always results in sizes above 10mb, making it hard to upload to gitlab.

local gif should not require login

hello, I am not sure if recording a local gif should require to login.

regards, dan

Local mode enhancements

Enhancements:

• specify a default local folder (perhaps through the new tape config)
• specify filename for recording

[Windows] - tape gif doesn't work

Error:

📼 Processing your tape... done
   Error: Command failed: C:\Users\IK\.tape\bin\ffmpeg -loglevel warning -nostats -hide_banner -i
   C:\Users\IK\AppData\Local\Temp/BagwormMuscleboundOgivePeon-raw.mp4 -filter_complex
   'fps=24,scale=iw*0.5:-1:flags=lanczos,split [o1] [o2];[o1] palettegen [p]; [o2] fifo [o3];[o3] [p]
   paletteuse=dither=bayer:bayer_scale=5:diff_mode=rectangle'
   C:\Users\IK\AppData\Local\Temp/BagwormMuscleboundOgivePeon.gif
   [AVFilterGraph @ 000001e046766ec0] No such filter: 'fps=24,scale=iw*0.5:-1:flags=lanczos,split'
   Error initializing complex filters.
   Invalid argument

   Code: 1

---

• os: win32
• arch: x64

EXDEV: cross-device link not permitted

hello, I've been trying to record a vid on my pc and I am gettingt the following error:

Error:

tape gif --local=./ --format=md
📱 Device: [android] herolte (samsung, SM-G930F, heroltexx, universal8890) - SDK 26 (ad0617020ca188820a)
Recording started in /tmp/LocativeDupGranulateInhalation-raw.mp4.

File saved and ready to upload!
📼 Processing your tape... done
🚴🏽‍♀️ Making your gif...... ✔️
›   Error: EXDEV: cross-device link not permitted, rename 
›   '/tmp/LocativeDupGranulateInhalation.gif' -> 
›   'LocativeDupGranulateInhalation.gif'

from what I've seen this error happens when trying to rename across partitions.
in my case /tmp and my project dir are on two different disks (hope it helps)

---

• os: linux / DISTRIB_DESCRIPTION="Ubuntu 18.04.5 LTS"
• arch: x64

thanks! dan

[Windows] Esc key doesn't work

When recording a Tape, pressing the escape key does nothing on Windows. The only way to terminate the recording of a tape is by pressing Ctrl+C twice and then hitting 'Y' when 'Terminate batch job' appears

Getting a TypeError: Cannot read property '0' of undefined

Been getting this error when I try to run tape gif --local=~/Screenshots

Error:

TypeError: Cannot read property '0' of undefined``` 


---
- **os**: darwin 
- **arch**: x64 

allow to choose a name for files created locally

hello,

it would be great to be able to set the file name, not just the directory for locally created files.

thanks! best,
dan