tessl/npm-tiktok-src

A tool for downloading TikTok videos with or without watermarks and automatically uploading them to Facebook Reels

—

Pending

Overview

Eval results

Files

Facebook Upload

Name: tessl/npm-tiktok-src
Author: tessl

Browser automation system for uploading videos to Facebook Reels using Puppeteer. Handles session management through exported cookies, video upload workflow, caption input, and video duration validation.

Capabilities

Reels Upload Function

Main function for uploading videos to Facebook Reels with automated browser workflow.

/**
 * Upload video to Facebook Reels via browser automation
 * @param namafile - Filename without extension (video should exist in ./download/ directory)
 * @param caption - Video caption/description to add
 * @returns Promise resolving to upload result status
 */
function ReelsUpload(namafile: string, caption: string): Promise<UploadResult>;

interface UploadResult {
  /** Upload status indicator */
  status: 'success' | 'error';
  /** Descriptive message about upload result */
  message: string;
}

Usage Examples:

import { ReelsUpload } from './lib/browserHandler.js';

// Basic upload (requires cookies.json and video file)
const result = await ReelsUpload('video123', 'Check out this amazing video! #viral');
if (result.status === 'success') {
  console.log('Upload successful:', result.message);
} else {
  console.log('Upload failed:', result.message);
}

// Handle different outcomes
const uploadResult = await ReelsUpload('longvideo', 'My caption');
switch (uploadResult.status) {
  case 'success':
    console.log('Video published to Reels');
    break;
  case 'error':
    console.log('Failed:', uploadResult.message);
    break;
}

Session Management

Functions for managing Facebook authentication through exported cookies.

/**
 * Check if valid Facebook session cookies exist
 * @returns Promise resolving to boolean indicating session validity
 */
function checkSession(): Promise<boolean>;

/**
 * Generate timestamped console log message
 * @param str - Message to log with timestamp
 */
function printLog(str: string): void;

Usage Examples:

// Check session before attempting upload
const hasValidSession = await checkSession();
if (!hasValidSession) {
  console.log('Please export Facebook cookies to cookies.json');
  return;
}

// Logging with timestamps
printLog('Starting upload process...');
// Output: [14:30:25] Starting upload process...

Browser Configuration

Browser Options

The module uses specific Puppeteer configuration for Facebook compatibility:

interface BrowserConfig {
  /** Chrome executable path from puppeteer */
  executablePath: string;
  /** Headless mode (set to false for debugging) */
  headless: boolean;
  /** Chrome launch arguments */
  args: string[];
}

const browserOptions: BrowserConfig = {
  executablePath: executablePath("chrome"),
  headless: false,
  args: [
    '--user-agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"',
    '--no-sandbox',
    '--mute-audio'
  ]
};

Page Navigation Options

interface PageOptions {
  /** Wait condition for page loads */
  waitUntil: 'networkidle0' | 'load' | 'domcontentloaded';
}

const browserPageOpt: PageOptions = { waitUntil: 'networkidle0' };

Browser Automation Selectors

XPath selectors used for Facebook Reels UI automation. These are critical for the upload workflow and may need updates if Facebook changes their interface.

/** Facebook UI element selectors */
interface FacebookSelectors {
  /** Upload button selector */
  uploadButtonSelector: string;
  /** Next button selectors for different steps */
  nextButtonSelector: string;
  nextButtonSelector2: string;
  nextButtonSelector3: string;
  /** Caption text area selector */
  textAreaSelector: string;
  /** Publish button selector */
  publishButtonSelector: string;
  /** Upload completion indicator */
  ended: string;
  /** 90-second duration limit detector */
  s90detector: string;
  /** Video cutting tool selector */
  cutvideoSelector: string;
}

// Current XPath selectors (may change with Facebook UI updates)
const selectors: FacebookSelectors = {
  uploadButtonSelector: '/html/body/div[1]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[2]/div[1]/div[2]/div/div/div[1]/div/div/div/div/div/div[1]',
  nextButtonSelector: '//*[starts-with(@id, "mount")]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[3]/div[2]/div/div/div',
  nextButtonSelector2: '//*[starts-with(@id, "mount")]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[3]/div[2]/div[2]/div[1]/div',
  nextButtonSelector3: '/html/body/div[1]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[3]/div[2]/div[2]/div[1]',
  textAreaSelector: '//*[starts-with(@id, "mount")]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[2]/div[1]/div[2]/div/div/div/div/div[1]/div[1]/div[1]',
  publishButtonSelector: '/html/body/div[1]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[3]/div[2]/div[2]/div[1]/div/div[1]/div',
  ended: '/html/body/div[1]/div/div[1]/div/div[5]/div/div/div[3]/div[2]/div/div/div[1]/div/div/div/div/div[2]/div[1]/div/div/div[2]/div[2]',
  s90detector: '/html/body/div[1]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[3]/div[1]/div[1]/div/div/div/div[2]/div/div/div/div/span/span',
  cutvideoSelector: '/html/body/div[1]/div/div[1]/div/div[3]/div/div/div[1]/form/div/div/div[1]/div/div[2]/div[1]/div[2]/div/div/div/div/div/div/div[1]/div/div'
};

Upload Workflow

The upload process follows these automated steps:

Session Validation: Check cookies.json for valid Facebook session
Page Navigation: Open Facebook Reels creation page
File Selection: Click upload button and select video file
Duration Check: Validate video is under 90 seconds
Caption Input: Add provided caption text
Publishing: Wait for upload processing and publish the Reel

Video Duration Handling

Facebook Reels have a 90-second limit. The module automatically detects videos over this limit:

// If video exceeds 90 seconds, the upload will fail with:
{
  status: "error",
  message: "Video Gagal di publish!"
}

Required Files

Cookies Configuration

The module requires a cookies.json file containing exported Facebook session cookies:

// cookies.json format (array of cookie objects)
[
  {
    "name": "cookie_name",
    "value": "cookie_value", 
    "domain": ".facebook.com",
    "path": "/",
    "expires": 1234567890,
    "httpOnly": true,
    "secure": true
  }
  // ... more cookies
]

Video File Location

Videos must be placed in the ./download/ directory with .mp4 extension:

Expected path: ./download/{namafile}.mp4
File must exist before calling ReelsUpload
Function uses Indonesian variable name namafile (meaning "filename")

Session Configuration

Additional session and browser configuration options:

/** Browser visibility control */
const browserHide: boolean = false;

/**
 * Print timestamped log messages
 * @param str - Message to log
 */
function printLog(str: string): void;

/**
 * Check if valid Facebook session exists
 * @returns Promise resolving to session validity
 */
function checkSession(): Promise<boolean>;

Error Handling

Common error scenarios and their handling:

Session Errors:

{
  status: "error",
  message: "INFO: Session tidak ditemukan..."
}

Upload Errors:

{
  status: "error", 
  message: "Video Gagal di publish!"
}

Duration Errors:

Videos over 90 seconds are automatically rejected
Module detects duration limit and prevents upload
Indonesian error message: "Durasi video tidak boleh lebih dari 90 detik."

Specific Error Messages:

// Indonesian language error messages used in implementation
{
  status: "error",
  message: "INFO: Session tidak ditemukan..."  // "Session not found"
}

{
  status: "error", 
  message: "Video Gagal di publish!"  // "Video failed to publish"
}

// Console messages during processing
"Durasi video tidak boleh lebih dari 90 detik."  // "Video duration cannot exceed 90 seconds"
"Video lebih dari 90 detik tidak terdeteksi"     // "Video over 90 seconds not detected"
"Berhasil membuka fb"                            // "Successfully opened Facebook"
"Menginput Caption..."                           // "Inputting caption..."
"Post ke Reels"                                  // "Post to Reels"
"Berhasil"                                       // "Success"