# Bot Tok

>**Attention:** Bot Tok operates using the Zefoy and Freer platforms. Temporary interruptions in services such as views, shares, favorites, and others may occur on these platforms. These interruptions are not caused by our software and do not imply a permanent failure. 
We want to clarify that these outages are temporary and services will be restored once Zefoy and Freer resolve the issues. This is important and relevant information for all new Bot Tok users.

Bot Tok is an TikTok Up Bot (likes, shares, favorites and views)
based in node.js, puppeteer and third-party providers (zefoy.com & freer.es).

🚨 Find help in [Telegram](https://t.me/bottok_help)

>**Attention:** BotTok <u>DOESN'T SEND FOLLOWERS</u>!!!
>
>**Attention:** Bot Tok automates the use of the zefoy.com or freer.es and is subject to availability. <u>NOT ALL MODES ARE AVAILABLE AT ALL TIMES</u>. It depends on whether they are available on provider at the moment.

>**Attention:** Before purchasing a licence key, please use the free version. Please note that due to the nature of this product, we regret to inform you that it <u>CANNOT BE RETURNED OR EXCHANGED</u>. Please consider your purchase decision carefully, as <u>ALL SALES ARE FINAL</u>.

>**Disclaimer:** Using a TikTok viewbot is against the platform's Terms of Service. We do not encourage the act or idea of artificially increasing the number of views, likes, shares or favorites of your videos. <u>The use of BotTok is at the user's own risk</u>.

- [Bot Tok](#bot-tok)
  - [Features](#features)
  - [Install](#install)
      - [Windows](#windows)
      - [Linux](#linux)
      - [Android (Termux)](#android-termux)
  - [Manual Install](#manual-install)
      - [Windows](#windows-1)
      - [Linux](#linux-1)
      - [Android (Termux)](#android-termux-1)
  - [Update](#update)
      - [Windows](#windows-2)
      - [Linux](#linux-2)
      - [Android (Termux)](#android-termux-2)
  - [Use](#use)
  - [Options](#options)
  - [Advanced](#advanced)
      - [Run a Task with a Video Directly](#run-a-task-with-a-video-directly)
      - [Limit Task Accumulations](#limit-task-accumulations)
      - [Use Custom Cookies](#use-custom-cookies)
      - [Use Proxy](#use-proxy)
      - [Use a Random Proxy from a List](#use-a-random-proxy-from-a-list)
      - [Filter Proxy from a List by Country](#filter-proxy-from-a-list-by-country)
      - [Use Custom User-Agent](#use-custom-user-agent)
      - [Use Custom Browser](#use-custom-browser)
      - [Run with Visible Browser Window](#run-with-visible-browser-window)
      - [Use Terminal Captcha](#use-terminal-captcha)
      - [Write Activity Log](#write-activity-log)
      - [Set Minimum Accumulation Limit](#set-minimum-accumulation-limit)
      - [Set Maximum Time Limit](#set-maximum-time-limit)
      - [Set Initial Accumulation Value](#set-initial-accumulation-value)
      - [Set Retry Timeout Value](#set-retry-timeout-value)
      - [Set Comment Hearts quantity](#set-comment-hearts-quantity)
      - [Filter Comments by Text](#filter-comments-by-text)
      - [Filter Comments by Author](#filter-comments-by-author)
      - [Get Currently Available Tasks](#get-currently-available-tasks)
      - [Get a Session Status](#get-a-session-status)
      - [Connect to an Existing Browser Instance](#connect-to-an-existing-browser-instance)
      - [New Bypass Cloudflare Manually](#new-bypass-cloudflare-manually)
        - [Android](#android)
        - [Linux](#linux-3)
        - [Windows](#windows-3)
      - [Bypass Cloudflare Manually](#bypass-cloudflare-manually)
        - [Android](#android-1)
        - [Linux](#linux-4)
        - [Windows](#windows-4)
      - [Trick to avoid being banned on Freer captcha](#trick-to-avoid-being-banned-on-freer-captcha)
        - [Android](#android-2)
        - [Linux](#linux-5)
        - [Windows](#windows-5)
  - [Expert](#expert)
      - [Detach Mode](#detach-mode)
      - [Multi Task Mode](#multi-task-mode)
  - [Premium (No Limitations)](#premium-no-limitations)
  - [Donate](#donate)
  - [Authors](#authors)

## Features

>**Attention:** The features that are with ❌ are integrated in the bot <u>BUT ARE PRACTICALLY NEVER AVAILABLE IN THE PROVIDERS</u>!

✅ Up Views (Zefoy & Freer)   
✅ Up Shares (Zefoy & Freer)  
✅ Up Favorites (Zefoy & Freer)  
✅ Up Comments Hearts (Zefoy & Freer)  
✅ Up Hearts (Zefoy & Freer)  
❌ Up Live Stream (Zefoy)  
✅ Up Live Views (Freer)  
✅ Auto Captcha Solver  
✅ Captcha in Terminal (Optional)  
✅ Captcha Viewer in Browser  
✅ Auto Bypass Cloudflare (Windows & Linux)  
✅ Smart Sessions Management (Cloudlfare & Zefoy/Freer Cookies, UA, Proxy)  
✅ Video URLs History  
✅ Random User-Agent  
✅ Proxy  
✅ Random Proxy from List  
✅ Filter Proxies by Country  
✅ Activity Log  
✅ Custom Accumulation Limit  
✅ Run in Windows, Linux and Android (Termux)  
💎 Not limited accumulations (Premium Mode)  
💎 Multi Task (Premium Mode)  
💎 Run as a Detach Process (Premium Mode)  

## Install

>**Attention:** To use Git and clone the repository you will need to have *SSH Public Key*. Take a look at this: [Adding a new SSH key to your GitHub account](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
Without this you may have problems installing. This will make it much easier to upgrade your BotTok to the latest version available with a single command.

>The following installation commands are provided for each operating system. Execute the command corresponding to your OS and follow the instructions, choose the default values by pressing enter or typing Y as appropriate. At some point during the installation a public ssh key will be generated and you will need to paste it into your GitHub account to continue. You can look in this documentation in the manual installation of your OS at the "Add your SSH Public Key" step for more details. After doing this step you will need to press enter on the tarminal to finish the installation. If everything went well BotTok should open.

#### Windows

📹 [Install in Windows Tutorial](https://youtu.be/4yvkC38avbs)

>**Attention:** Windows Defender may recognize BotTok as a virus. In this case you should temporarily disable the real-time scanning and install it.

First look at [how to add a SSH Public Key](https://medium.com/devops-with-valentine/2021-how-to-set-up-your-ssh-key-for-github-on-windows-10-afe6e729a3c0) in your github account on Windows.


1. Save the Windows installer file [win-install.bat](https://raw.githubusercontent.com/jfadev/bottok/main/win-install.bat) to your user folder and run it,
or Run in terminal

```bash
curl -o win-install.bat https://raw.githubusercontent.com/jfadev/bottok/main/win-install.bat & win-install.bat
```

#### Linux

📹 Install in Linux Tutorial (coming soon)

1. Run in terminal

```bash
sudo apt install wget && wget https://raw.githubusercontent.com/jfadev/bottok/main/ubuntu-install.sh && chmod +x ubuntu-install.sh && ./ubuntu-install.sh
```

#### Android (Termux)

📹 [Install in Android Tutorial](https://youtu.be/INFmtshmSM0)

Requirements: [termux](https://termux.dev/en/) (install Termux in your Android phone from F-Droid store, The PlayStore version ins outdated and not work)

1. Run in Termux terminal (Install Alpine in Termux)

```bash
pkg upgrade && pkg install wget && wget https://raw.githubusercontent.com/jfadev/bottok/main/termux-install.sh && chmod +x termux-install.sh && ./termux-install.sh
```

2. Run in Alpine terminal

```bash
wget https://raw.githubusercontent.com/jfadev/bottok/main/alpine-install.sh && chmod +x alpine-install.sh && ./alpine-install.sh
```

## Manual Install

#### Windows

![](doc/6.png?raw=true)

>**Attention:** Windows Defender may recognize BotTok as a virus. In this case you should temporarily disable the real-time scanning and install it.

Requirements: [git](https://git-scm.com/downloads), [nodejs](https://nodejs.org/) >=18 (Latest [maintenance LTS](https://github.com/nodejs/Release#release-schedule) version),
 [npm](https://www.npmjs.com/) and [chrome/chromium](https://www.chromium.org/chromium-projects/).

1. Install [nodejs](https://nodejs.org/en/download/), [git](https://git-scm.com/downloads)

2. Add your SSH Public Key to your GitHub account ([more info](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=windows) and [info](https://medium.com/devops-with-valentine/2021-how-to-set-up-your-ssh-key-for-github-on-windows-10-afe6e729a3c0)). In ssh-keygen use the default values (press enter)

```bash
ssh-keygen
```

Open with Notepad.exe the file `C:\Users\{your-user}\.ssh\id_rsa.pub`, copy its content and paste it into your GitHub account in [https://github.com/settings/ssh/new](https://github.com/settings/ssh/new)

Note: you may need to create the `.ssh` folder manually in your Windows user folder if it is not created automatically.

![](doc/8.png?raw=true)


3. Clone this repository in terminal (fingerprint: yes)

```bash
git clone git@github.com:jfadev/bottok.git
```

4. Install Bot Tok

```bash
cd bottok
npm install
```

#### Linux

![](doc/1.png?raw=true)

Requirements: [git](https://git-scm.com/downloads), [nodejs](https://nodejs.org/) >=18 (Latest [maintenance LTS](https://github.com/nodejs/Release#release-schedule) version),
 [npm](https://www.npmjs.com/) and [chrome/chromium](https://www.chromium.org/chromium-projects/).

1. Install [nodejs](https://nodejs.org/), [npm](https://www.npmjs.com/), [git](https://git-scm.com/downloads) and [openssh](https://www.openssh.com/)
   
```bash
sudo apt install nodejs
sudo apt install npm
sudo apt install git
sudo apt install openssh-client
```

2. Add your SSH Public Key to your GitHub account ([more info](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=linux)). In ssh-keygen use the default values (press enter)

```bash
ssh-keygen
cat ~/.ssh/id_rsa.pub
```

Copy its content and paste it into your GitHub account in [https://github.com/settings/ssh/new](https://github.com/settings/ssh/new)

![](doc/8.png?raw=true)


3. Clone this repository in terminal (fingerprint: yes)

```bash
git clone git@github.com:jfadev/bottok.git
```

4. Install Bot Tok
```bash
cd bottok
npm install
```

#### Android (Termux)

![](doc/5.png?raw=true)

Requirements: [termux](https://termux.dev/en/) (install Termux in your Android phone from F-Droid store, The PlayStore version ins outdated and not work)

There is no build of Google Chrome available for ARM at this moment, so using chromium instead.
Installing chromium on Termux directly requires snap which is another big hurdle so alternatively using alpine distro here.

1. Install [alpine](https://alpinelinux.org) in termux

```bash
pkg upgrade
apt update
apt upgrade
pkg install proot-distro
proot-distro install alpine
proot-distro login alpine
```

2. In alpine install chromium
```bash
apk update && apk add --no-cache nmap && \
    echo http://nl.alpinelinux.org/alpine/v3.17/community > /etc/apk/repositories
    echo http://nl.alpinelinux.org/alpine/v3.17/main >> /etc/apk/repositories
    apk update && \
    apk add --no-cache \
    chromium
```

3. Install [nodejs](https://nodejs.org/), [yarn](https://yarnpkg.com/), [git](https://git-scm.com/downloads), and [openssh](https://www.openssh.com/)
   
```bash
apk add nodejs
apk add yarn
apk add git
apk add openssh
```

4. Add your SSH Public Key to your GitHub account ([more info](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account?platform=linux)). In ssh-keygen use the default values (press enter)

```bash
ssh-keygen
cat ~/.ssh/id_rsa.pub
```

Copy its content and paste it into your GitHub account in [https://github.com/settings/ssh/new](https://github.com/settings/ssh/new)

![](doc/8.png?raw=true)


5. Clone this repository in terminal (fingerprint: yes)

```bash
git clone git@github.com:jfadev/bottok.git
```

6. Install Bot Tok
```bash
cd bottok
yarn install
```

*Note:* To enter Alpine from Termux with [proot-distro](https://github.com/termux/proot-distro) use the following command:
```bash
proot-distro login alpine
```

## Update

#### Windows

1. Run in terminal

```bash
cd bottok
win-update.bat
```

#### Linux

1. Run in terminal

```bash
cd bottok
./ubuntu-update.sh
```

#### Android (Termux)

1. Run in terminal

```bash
cd bottok
./alpine-update.sh
```
*Note:* use `./ubuntu-update.sh` if instead of alpine you decided to use another distro like ubuntu for example.

## Use

Type the following command in your terminal:

```bash
cd bottok
node bottok.js
```
And follow the instructions, solve the captcha in the console if necessary, choose one of the available tasks and let the bot work.

>**Attention:** On Windows you can open BotTok by simply clicking on the `win-bottok.bat` file.

>**Attention:** On Windows Chromium can have the problem of opening multiple windows. We can control another browser like Chrome present on your machine. For this we just need the path to chrome.exe and launch BotTok as follows:

```bash
node bottok.js -b "C:\Program Files\Google\Chrome\Application\Chrome.exe"
```

## Options

```txt
Usage: node bottok.js [options]

Options:
  -h, --help                 Show help
  -v, --version              BotTok version
  -l, --video <link>         TikTok video URL to perform the task on
  -t, --task <task>          Task to perform on the TikTok video (example: 'Up Views')
  -q, --provider <prov>      Provider Zefoy or Freer (default: Zefoy)
  -c, --cookies <path>       File path to store session cookies (default: cookies.json)
  -u, --user-agent <ua>      User agent to be used (default: random user-agent)
  -p, --proxy <proxy>        The proxy to be used (example: http://localhost:8080)
  -s, --proxies <path>       The path of the proxies file to use randomly (default: proxies.txt)
  -n, --proxies-country <c>  Filter proxies by country code (example: 'FR' or list 'ES,FR,IT')
  -b, --browser <path>       Path to a browser executable to use instead of Chromium  
  -r, --browser-remote <ws>  Set browser WS endpoint to connect to an existing instance
  -j, --browser-user <path>  Set custom user data directory of browser (profile folder)
  -w, --no-headless          Open visible browser window  
  -k, --terminal-captcha     Terminal captcha instead of auto solver
  -o, --log                  Write activity log (activity.log)
  -m, --minimal              Hide ASCII art header
  -d, --detach               Output mode for background processes
  -x, --limit <int>          By the time the accumulation limit is reached
  -z, --min-limit <int>      If it does not accumulate x amount in 60 minutes it stops
  -f, --max-time <int>       Sets a maximum time limit in hours before stops
  -a, --available-tasks      Returns the currently available tasks
  -g, --session-status       Returns the session status
  -i, --init-accums <int>    Set a initial accumulation value (default: 0)
  -e, --verbose              Display detailed processing information in logs
  -R, --retry-timeout <int>  Waiting trying again timeout in minutes (default: 1)
  -C, --wait-threshold <int> Cooldown applies if wait time exceeds this in minutes (default: 60)
  -Y, --wait-cooldown <int>  Time to wait when threshold is triggered in minutes (default: 20)
  -H, --c-hearts-qty <int>   Set the number of hearts to send to the comment (25, 50 or 100)
  -T, --c-text-filter <str>  Filter comments by comment text
  -U, --c-user-filter <str>  Filter comments by comment author
  -P, --proxy-nocf           Exclude proxies with Cloudflare protection
```

## Advanced

#### Run a Task with a Video Directly

Set task with `-t` flag (`Up Views`, `Up Shares`, `Up Favorites`) and video url with `-l` flag. Zefoy is used by default as provider, if you want to use Freer as provider add the `-q 'Freer'` flag.
```bash
node bottok.js -t 'Up Views' -l https://www.tiktok.com/@jfadev/video/7216697213693529349
```

#### Limit Task Accumulations

Set the limit accumulations value with `-x` flag. The bot will stop when this limit is reached.
```bash
node bottok.js -t 'Up Views' -x 20000 -l https://www.tiktok.com/@jfadev/video/7216697213693529349
```


#### Use Custom Cookies

```bash
node bottok.js -c cookies2.json
```

#### Use Proxy

```bash
node bottok.js -p 127.0.0.1:8080
```
or
```bash
node bottok.js -p http://127.0.0.1:8080
```
or
```bash
node bottok.js -p user:password@127.0.0.1:8080
```

#### Use a Random Proxy from a List

```bash
node bottok.js -s proxies.txt
```

File example:
```txt
202.61.204.51:80
47.91.45.198:8888
user:password@47.91.45.198:8888
user2:password2@202.61.204.51:80
```

#### Filter Proxy from a List by Country
You can see the list of country codes here [country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

```bash
node bottok.js -s proxies.txt -n US
```
or
```bash
node bottok.js -s proxies.txt -n 'US,UK,ES,IT'
```

#### Use Custom User-Agent

```bash
node bottok.js -u 'Mozilla/5.0 (iPad; CPU OS 8_4 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12H143 Safari/600.1.4'
```

#### Use Custom Browser

Path to a browser executable to use instead of the bundled Chromium.
Note that Puppeteer is only guaranteed to work with the bundled Chromium, so use this setting at your own risk.

*Linux*
```bash
node bottok.js -b /usr/bin/google-chrome-stable
```

*Windows*
```bash
node bottok.js -b "C:\Program Files\Google\Chrome\Application\Chrome.exe"
```

#### Run with Visible Browser Window

```bash
node bottok.js -w
```

#### Use Terminal Captcha

If the auto captcha solver has problems you can solve the captcha manually.
You can also view the captcha image at the following address
in your browser `http://localhost:8077`

```bash
node bottok.js -k
```

#### Write Activity Log

Stored in the `activity.log` file

```bash
node bottok.js -o
```
Record structure:
[`datetime`] [`user-gent`] [`session-id`] [`task`] `total` (+`accumulations`) `URL`

![](doc/7.png?raw=true)

Display detailed processing information (verbose) in logs

```bash
node bottok.js -o -e
```

#### Set Minimum Accumulation Limit

If you don't accumulate x views/favorites/shares in 60 minutes it stops.

```bash
node bottok.js -z 100
```

#### Set Maximum Time Limit

If the maximum time limit in hours is reached, it stops.

```bash
node bottok.js -f 24
```
#### Set Initial Accumulation Value

The counter starts with this value. Useful for resuming tasks.

```bash
node bottok.js -i 500000
```

#### Set Retry Timeout Value

The timeout period in minutes before retrying a failed attempt. Useful for controlling the retry intervals.

```bash
node bottok.js -R 5
```

#### Set Comment Hearts quantity

Set the number of hearts to send to the comment (25, 50 or 100).
Only work with Zefoy.

```bash
node bottok.js -H 100
```


#### Filter Comments by Text

List only comments that contain this text.

```bash
node bottok.js -T 'hello' 
```

#### Filter Comments by Author

List only those comments where the author's name contains this text.

```bash
node bottok.js -U 'jfadev'
```

#### Get Currently Available Tasks

Returns the currently available tasks.

```bash
node bottok.js -a
```

Return example:
```txt
Up Comments Hearts, Up Views, Up Shares, Up Favorites
```

#### Get a Session Status

Returns the currently session status.

```bash
node bottok.js -g
```
or
```bash
node bottok.js -g -c cookies2.json
```

Return status examples:
```txt
Cloudflare Valid / Zefoy Expired
Cloudflare Valid / Zefoy Valid
Cloudflare Expired / Zefoy Expired
```
or
```bash
node bottok.js -g -q Freer -c cookies3.json
```

Return status examples:
```txt
Cloudflare Valid / Freer Expired
Cloudflare Valid / Freer Valid
Cloudflare Expired / Freer Expired
```

#### Connect to an Existing Browser Instance

Open Google Chrome with the flag `--remote-debugging-port=9222`:

```bash
/usr/bin/google-chrome-stable --remote-debugging-port=9222
```

Open with that browser the following url `http://127.0.0.1:9222/json/version` and retrieve the value of `webSocketDebuggerUrl` for example: `ws://127.0.0.1:9222/devtools/browser/e5095d9d-9095-4be8-a418-cd8a3f4f020a`.

Run BotTok with the `-r` flag:

```bash
node bottok.js -r ws://127.0.0.1:9222/devtools/browser/e5095d9d-9095-4be8-a418-cd8a3f4f020a
```

#### New Bypass Cloudflare Manually

When Cloudflare's protection or Captcha cannot be resolved automatically, you must create a valid cookie with the following simple instructions.

##### Android

>**Attention:** Kiwi Browser has been discontinued and is no longer available on the Play Store. However, you can still download the latest APK from APKPure at:
https://apkpure.com/kiwi-browser-fast-quiet/com.kiwibrowser.browser

1. Install "Kiwi Browser" (chromium-based browser that allows you to install extensions).
2. Open Kiwi Browser, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
3. Click on the 3 dots button → DevTools → Network → request → right click → Copy as cURL.
4. Open Termux
5. `proot-distro login alpine`
6. `cd bottok`
7. `nano cookies.txt`
8.  Click on the screen, and click on "Paste".
9.  Click CTRL, then O, then ENTER.
10. Click CTRL, then click X.
11. `node bottok.js`

##### Linux

1. Open Chrome, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
2. Press F12 → DevTools → Network → request → right click → Copy as cURL.
3. Open Terminal
4. `cd bottok`
5. `nano cookies.txt`
6.  Click second mouse button, and click on "Paste".
7.  Click CTRL, then O, then ENTER.
8.  Click CTRL, then click X.
9.  `node bottok.js`

##### Windows

1. Open Chrome, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
2. Press F12 → DevTools → Network → request → right click → Copy as cURL.
3. Open bottok folder
4. Edit/Create cookies.txt file, Paste with CTRL+V, Save file.
5. Click on `win-bottok.bat`


#### Bypass Cloudflare Manually

The Cloudflare bypass on Windows and Linux OS are done automatically but on Android (Termux) you still have to do this process manually. If for some reason the automatic bypass does not work, please follow the instructions below for your OS.

##### Android

>**Attention:** Kiwi Browser has been discontinued and is no longer available on the Play Store. However, you can still download the latest APK from APKPure at:
https://apkpure.com/kiwi-browser-fast-quiet/com.kiwibrowser.browser

1. Open Playstore and install "Kiwi Browser" (chromium-based browser that allows you to install extensions).
2. Open Kiwi Browser, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
3. Click on the 3 dots button, click on "Extensions", click on "+(from store)", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
4. In the zefoy tab, click on the 3 dots button, scroll down to the bottom, click on "Copy Cookies". You will see on the screen "Copied".
5. Open Termux
6. `proot-distro login alpine`
7. `cd bottok`
8. `rm cookies.json`
9. `nano cookies.json`
10. Click on the screen, and click on "Paste".
11. Click CTRL, then O, then ENTER.
12. Click CTRL, then click X.
13. `node bottok.js`

##### Linux

1. Open Chrome, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
2. Click on the 3 dots button, click on "Extensions", click on "Visit Chrome Web Store", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
3. In the zefoy tab, click on extensions button, click on "Copy Cookies". You will see on the screen "Copied".
4. Open Terminal
5. `cd bottok`
6. `rm cookies.json`
7. `nano cookies.json`
8.  Click second mouse button, and click on "Paste".
9.  Click CTRL, then O, then ENTER.
10. Click CTRL, then click X.
11. `node bottok.js`

##### Windows

1. Open Chrome, enter to zefoy.com, pass Cloudflare's protection, solve the captcha.
2. Click on the 3 dots button, click on "Extensions", click on "Visit Chrome Web Store", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
3. In the zefoy tab, click on extensions button, click on "Copy Cookies". You will see on the screen "Copied".
4. Open bottok folder
5. Edit/Create cookies.json file, Overwrite/Paste with CTRL+V, Save file (create on notepad at bottok file > paste cookies > save notepad > and it will save file name as cookies.txt > rename notepad > change .txt to .json).
6. Click on `win-bottok.bat`


#### Trick to avoid being banned on Freer captcha

Freer's captcha may block your IP after multiple failed attempts. To prevent this, the safest approach is to bypass the automatic solver and manually paste the previously generated cookies.

##### Android

>**Attention:** Kiwi Browser has been discontinued and is no longer available on the Play Store. However, you can still download the latest APK from APKPure at:
https://apkpure.com/kiwi-browser-fast-quiet/com.kiwibrowser.browser

1. Open Playstore and install "Kiwi Browser" (chromium-based browser that allows you to install extensions).
2. Open Kiwi Browser, enter to nreer.com, solve the captcha.
3. Click on the 3 dots button, click on "Extensions", click on "+(from store)", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
4. In the freer tab, click on the 3 dots button, scroll down to the bottom, click on "Copy Cookies". You will see on the screen "Copied".
5. Open Termux
6. `proot-distro login alpine`
7. `cd bottok`
8. `rm cookies2.json`
9. `nano cookies2.json`
10. Click on the screen, and click on "Paste".
11. Click CTRL, then O, then ENTER.
12. Click CTRL, then click X.
13. `node bottok.js`

##### Linux

1. Open Chrome, enter to nreer.com, solve the captcha.
2. Click on the 3 dots button, click on "Extensions", click on "Visit Chrome Web Store", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
3. In the freer tab, click on extensions button, click on "Copy Cookies". You will see on the screen "Copied".
4. Open Terminal
5. `cd bottok`
6. `rm cookies2.json`
7. `nano cookies2.json`
8.  Click second mouse button, and click on "Paste".
9.  Click CTRL, then O, then ENTER.
10. Click CTRL, then click X.
11. `node bottok.js`

##### Windows

1. Open Chrome, enter to nreer.com, solve the captcha.
2. Click on the 3 dots button, click on "Extensions", click on "Visit Chrome Web Store", search in the chrome web store search bar for "Copy Cookies" extension, click on "Add to Chrome".
3. In the freer tab, click on extensions button, click on "Copy Cookies". You will see on the screen "Copied".
4. Open bottok folder
5. Edit/Create cookies2.json file, Overwrite/Paste with CTRL+V, Save file (create on notepad at bottok file > paste cookies > save notepad > and it will save file name as cookies2.txt > rename notepad > change .txt to .json).
6. Click on `win-bottok.bat`


## Expert

#### Detach Mode

With the `-d` or `--detach` flag BotTok manages to work as a background process opening many interesting possibilities.

#### Multi Task Mode

We provide a batch script in both Windows and Linux versions. This batch process reads from the `tasks.csv` file one task per line and launches bottok background processes with one task, one video and a specific accumulation limit in a loop. The number of simultaneous tasks will depend on the resources of your device. Feel free to modify this simple script to suit your needs. 

**Example of tasks.csv:**

Column structure:
`task`,`limit`,`URL`,`provider`

Limit 0 = unlimited

![](doc/9.png?raw=true)

```txt
Up Views,10000,https://www.tiktok.com/@user/video/7218328781327584518,Zefoy
Up Favorites,500,https://www.tiktok.com/@user/video/7218328781327584518,Zefoy
Up Shares,1000,https://www.tiktok.com/@user/video/7218328781327584518,Zefoy
Up Views,50000,https://www.tiktok.com/@user/video/7208664677738450181,Freer
Up Favorites,5000,https://www.tiktok.com/@user/video/7208664677738450181,Freer
Up Shares,2000,https://www.tiktok.com/@user/video/7208664677738450181,Zefoy
Up Views,0,https://www.tiktok.com/@user/video/7194941936069922053,Freer
Up Favorites,15000,https://www.tiktok.com/@user/video/7194941936069922053,Zefoy
Up Shares,9000,https://www.tiktok.com/@user/video/7194941936069922053,Zefoy
```

Note: you may need an empty line in the last line on some systems.

Edit your `tasks.csv` file and run the batch process `multi-task.sh` or `multi-task.bat`.

*Linux*
```bash
./multi-tash.sh
```
or with custom tasks file path
```bash
./multi-tash.sh tasks.csv
```

*Windows*
```bash
multi-task.bat
```
or with custom tasks file path
```bash
multi-task.bat tasks.csv
```
![](doc/11.png?raw=true)

Or use the -e or --verbose flags to display more detailed information.
![](doc/10.png?raw=true)

## Premium (No Limitations)

>**Attention:** Before purchasing a licence key, please use the free version. Please note that due to the nature of this product, we regret to inform you that it <u>CANNOT BE RETURNED OR EXCHANGED</u>. Please consider your purchase decision carefully, as <u>ALL SALES ARE FINAL</u>.

>**Attention:** The license key is <u>LIFETIME</u> and you will be able to enjoy all versions.

The **FREE** version with limited accumulations (views, likes, shares, etc...).

The advantage of acquiring the license is that the bot continues to 
work indefinitely and accumulates large amounts of views, shares, etc...
Unlock this limitation by purchasing a license at [HERE!](https://jordifernandes.com/service/bottok)

Paste a License Key here:
(Main Menu > License > Add License)

![](doc/4.png?raw=true)

## Donate

If you want to give a donation for the developers, you can do it here https://jordifernandes.com/donate/
Thank you very much!!!!

## Authors

- [Jordi Fernandes (@jfadev)](https://github.com/jfadev)
