https://github.com/kfermercer/chaturbate-grabber
CB | SC Recorder You're Searching For.
https://github.com/kfermercer/chaturbate-grabber
chaturbate chaturbate-recorder stripchat stripchat-recorder
Last synced: 3 months ago
JSON representation
CB | SC Recorder You're Searching For.
- Host: GitHub
- URL: https://github.com/kfermercer/chaturbate-grabber
- Owner: KFERMercer
- License: gpl-3.0
- Created: 2019-08-21T08:43:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-17T07:30:23.000Z (3 months ago)
- Last Synced: 2025-03-29T15:07:54.008Z (3 months ago)
- Topics: chaturbate, chaturbate-recorder, stripchat, stripchat-recorder
- Language: Shell
- Homepage:
- Size: 273 KB
- Stars: 131
- Watchers: 10
- Forks: 26
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Chaturbate-Grabber | CtbCap
Chaturbate-Grabber/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 so braindead.
- **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.
> I'm lighter, yet I'm more powerful.
Usage | Deploy
### **Launch with One-Command:**
**Open your whatever terminal & drop this:**
```shell
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -h
```
> [!NOTE]
> Put the options after `@` . e.g:\
> `sh -c <...curl...stuff...> @ -ef ~/rec your_mom`
> [!TIP]
> You can also choose to download/upgrade CtbCap to your local:\
> `curl -L https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap -o ctbcap && chmod +x ctbcap`\
> After its done, run `./ctbcap` to launch CtbCap.
> [!TIP]
> **Termux is Supported.**
##
### **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:**
- [Docker Hub](https://hub.docker.com/r/kfermercer/ctbcap): `docker pull kfermercer/ctbcap:latest`
- [GitHub Package](https://github.com/KFERMercer/chaturbate-grabber/pkgs/container/ctbcap): `docker pull ghcr.io/kfermercer/ctbcap:latest`
Platform
Available
Status
x86
✅
x86_64
✅
armhf
✅
armv7
✅
aarch64
✅
loongarch64
✅
ppc64le
✅
riscv64
✅
s390x
✅
#### **Run As Compose Daemon (Recommend) :**
1. Custom your own compose file:
```shell
curl -L https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/docker-compose.sample.yml -o ctbcap-compose.yml
```
Then edit `./ctbcap-compose.yml` to configure.
2. Deploy the compose daemon:
```shell
# 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:**
```shell
docker run -t --rm \
-u $(id -u):$(id -g) \
-v :/save \
-v :/log \
-e TZ=Asia/Shanghai \
-e = \
... \
kfermercer/ctbcap -h
```
> [!NOTE]
> Option `-u :` 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](#container-variables)
#### **Update the Container Image:**
See [Official CtbCap Container Registry](#official-ctbcap-container-registry).
#### **Container Variables:**
| Variables | Value Type | Value Examples | Default | Necessary 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 |
| CUT_TIME | INT | `0`
`911`
`6324`
... | `3600` | No |
| TZ | [TZ identifier](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List) | `UTC`
`Asia/Shanghai`
`Africa/Harare`
... | `UTC` | No
if you [live in Greenwich](https://www.royalgreenwich.gov.uk/info/200258/parking_transport_and_streets/810/find_a_public_toilet_in_royal_greenwich) |
| EDGING_MODE | Inactive if not `1` | `1`
`12306`
... | `uncles make me pee white` | No |
| DEBUG_MODE | Inactive if not `1` | `1`
`-999`
`i was born from my sis`
... | `your mom is so hot` | No |
Command Examples
#### Get help for commands:
```shell
# Local:
./ctbcap -h
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -h
# Docker CLI:
docker run -t --rm kfermercer/ctbcap -h
```
#### Simping your girl with nonstop:
```shell
# Local:
./ctbcap -f your_girl
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -f your_girl
# Docker CLI:
docker run -t --rm -u : -v :/save kfermercer/ctbcap your_girl
```
#### Grab stream URL and generating FFmpeg command, but don't start recording:
```shell
# Local:
./ctbcap -l your_girl
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -l your_girl
# Docker CLI:
docker run -t --rm kfermercer/ctbcap -l your_girl
```
#### Simping your girl's stream and don't cut the file (cut the files every 3600 seconds by default) :
```shell
# Local:
./ctbcap -f -c 0 your_girl
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -f -c 0 your_girl
# Docker CLI:
docker run -t --rm -u : -v :/save kfermercer/ctbcap -c 0 your_girl
```
#### Simping your girl's stream and cut the files by every 1800 seconds (30 min) :
```shell
# Local:
./ctbcap -f -c 1800 your_girl
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -f -c 1800 your_girl
# Docker CLI:
docker run -t --rm -u : -v :/save kfermercer/ctbcap -c 1800 your_girl
```
#### Show version & runtime info:
```shell
# Local:
./ctbcap -v
# One-Command Run:
sh -c "$(curl -sL https://raw.githubusercontent.com/KFERMercer/chaturbate-grabber/master/ctbcap)" @ -v
# Docker CLI:
docker run -t --rm -u : kfermercer/ctbcap -v
```
Branch Description
[`master`](https://github.com/KFERMercer/chaturbate-grabber/tree/master): Main Branch. Use this branch for practical purposes.
[`dev`](https://github.com/KFERMercer/chaturbate-grabber/tree/dev): Development Branch. Includes latest features and optimizations. But it may be unstable.
##
(. )( .)