Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

KFERMercer/ctbcap

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CtbCap is a Functional, Reliable, Easy to Use, yet Extremely Lightweight Recorder/Watchbot for Chaturbate|StripChat.

Key Advantages

  • Lightweight - Written in most basic Shell Scripts to strive POSIX compatibility and energy efficiency.

    Py is too heavy.

  • All platforms available - All functions are available with just require curl & ffmpeg.

    $0.1 Temu Phone? No problem.

  • Multifunction - Auto Recording; Auto Monitoring; Auto Stopping; Large-Scale Deployment... Just find by yourself.

    Lighter, yet more powerful.

Usage | Deploy

Launch with One-Command:

Open your whatever terminal & drop this:

sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @ -h

Note

Put the options after @ like:
sh -c <...curl...stuff...> @ -ef ~/rec <Username|URL>

Tip

You can also choose to download/upgrade CtbCap to your local:
curl -L https://kfermercer.github.io/ctbcap/ctbcap -o ctbcap && chmod +x ctbcap

Then, run ./ctbcap to launch CtbCap.

Tip

Available on Termux.

Docker Container (Recommend) :

Note

If you're using such platforms that have good support for Docker or similar, I highly recommend to use this method: More serious; High-Availability; Everything runs in containers; Easily configures lot of chatrooms at the same time.

Official CtbCap Container Registry:

Registry Docker CLI
Docker Hub docker pull kfermercer/ctbcap:latest
GitHub Package docker pull ghcr.io/kfermercer/ctbcap:latest
Platform Build Status
x86
x86_64
armhf
armv7
aarch64
loongarch64
ppc64le
riscv64
s390x

Run As Compose Daemon (Recommend) :

  1. Custom your own compose file:

    curl -L https://kfermercer.github.io/ctbcap/docker-compose.sample.yml -o ctbcap-compose.yml

    Then edit ./ctbcap-compose.yml to configure.

  2. Deploy the compose daemon:

    # Run as background daemon:
    docker compose -f ./ctbcap-compose.yml up -d --remove-orphans
    
    # Check the status of the daemon:
    docker compose -f ./ctbcap-compose.yml logs -f
    
    # Stop & remove the daemon:
    docker compose -f ./ctbcap-compose.yml down --remove-orphans

Run with Docker CLI:

docker run -t --rm \
-u <UID>:<GID> \
-v </path/to/recdir>:/save \
-v </path/to/logdir>:/log \
-e TZ=Asia/Shanghai \
-e <VAR>=<value> \
... \
kfermercer/ctbcap [options...] <Username|URL>

Note

-u <UID>:<GID> Allows you to specify the user (UID) and group (GID) that the container will run as. For example, -u 0:0 will run the container as root.

If you don't specify -u, the container will running as 1000:1000.

Use -u $(id -u):$(id -g) to use your current UID and GID.

Note

For Container Variables, see: Container Variables.

Update the Container Image:

See Official CtbCap Container Registry.

Container Variables:

Variables Value Type Value Examples Default Recommend to Change
MODEL Streamer's Username or Chatroom URL 3rd8008
s1mp_L0r3-87
https://chaturbate.com/your_sister
https://stripchat.com/dicklessman
...
- Yes
PLATFORM chaturbate or stripchat chaturbate
stripchat
chaturbate Yes, if not Chaturbate.
EDGING_MODE Inactive if not 1 1
12306
...
uncles make me pee white Yes, if the streamer is currently offline.
TZ TZ identifier UTC
Asia/Shanghai
Africa/Harare
...
UTC No, if you live in Greenwich.
CUT_TIME INT 0
911
6324
...
3600 No
DEBUG_MODE Inactive if not 1 1
-999
i was born from my sis
...
your mom is so hot No
NOBANNER Inactive if not 1 1
well, that reminds me
...
^>vvv (Docker CLI)
1 (Compose file)
No

Command Examples

Get help for commands:

# Local:
./ctbcap

# One-Command Run:
sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @

# Docker CLI:
docker run -t --rm kfermercer/ctbcap

Simping your girl with nonstop:

# Local:
./ctbcap <Username|URL>

# One-Command Run:
sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @ <Username|URL>

# Docker CLI:
docker run -t --rm -u $(id -u):$(id -g) -v ${PWD}/ctbcap_rec:/save kfermercer/ctbcap <Username|URL>

Note

By default, the recording file will be saved to ${PWD}/ctbcap_rec/.
See the command help to change it if you want.

Simping your girl and cut the recording files by every 1800 seconds:

# Local:
./ctbcap -c 1800 <Username|URL>

# One-Command Run:
sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @ -c 1800 <Username|URL>

# Docker CLI:
docker run -t --rm -u $(id -u):$(id -g) -v ${PWD}/ctbcap_rec:/save kfermercer/ctbcap -c 1800 <Username|URL>

Note

By default, the recording files will get cut every 3600 seconds (60 min).
Set the -c to 0 will disable the file cutting.

Grab stream URL and generating FFmpeg command, but don't start recording:

# Local:
./ctbcap -l <Username|URL>

# One-Command Run:
sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @ -l <Username|URL>

# Docker CLI:
docker run -t --rm kfermercer/ctbcap -l <Username|URL>

Show version & runtime info:

# Local:
./ctbcap -v

# One-Command Run:
sh -c "$(curl -sL https://kfermercer.github.io/ctbcap/ctbcap)" @ -v

# Docker CLI:
docker run -t --rm kfermercer/ctbcap -v

Branch Description

master: Main Branch. Use this branch for practical purposes.

dev: Development Branch. Includes latest features and optimizations. But it may be unstable.

(. )( .)

About

The CB/SC Recorder You Looking For.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 
Morty Proxy This is a proxified and sanitized view of the page, visit original site.