🎬 Bouflix — Movies & TV Shows

Create MySQL Database

In cPanel → MySQL® Databases → create a new database (e.g. bouflix).

Create Database User

Create a user with a strong password and grant ALL PRIVILEGES on the database.

Note Your Credentials

Host: localhost
Database: your_cpanel_user_bouflix
Username: your_cpanel_user_dbuser
Password: your_password
Port: 3306

Install MySQL

sudo apt update
sudo apt install mysql-server -y
sudo mysql_secure_installation

Create Database & User

sudo mysql -u root -p

CREATE DATABASE bouflix CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'bouflix_user'@'localhost' IDENTIFIED BY 'StrongP@ssw0rd';
GRANT ALL PRIVILEGES ON bouflix.* TO 'bouflix_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Extract the downloaded ZIP

Right-click the Bouflix ZIP file and click Extract Here (or Extract files…). You'll get a folder containing WebPanel inside.

Open File Manager

In cPanel, click File Manager to open the file browser.

Create a new folder

Click + Folder to create a new directory for the panel.

Name the folder

Enter the folder name (e.g. bouflix) and click Create New Folder.

Enter the new folder

Double-click the folder to open it.

Upload the WebPanel ZIP

Click the Upload button in the top toolbar.

Drag & drop the WebPanel ZIP

Before uploading, compress the WebPanel folder on your PC into a ZIP file (right-click → Send to → Compressed folder, or use 7-Zip/WinRAR). Then drag and drop the ZIP into the upload area.

Go back when upload is complete

Wait for the upload to finish, then click the back link to return to the folder.

Extract the WebPanel ZIP

Right-click the uploaded ZIP file and click Extract. This will extract all files into the current directory.

Open MySQL Databases

Go back to cPanel home and click MySQL® Databases (or Manage My Databases).

Create a new database

Enter a database name (e.g. bouflix_db) and click Create Database.

Create a database user

Scroll down and create a new MySQL user with a strong password.

Add user to database

Link the user to the database you just created.

Grant ALL PRIVILEGES

Check ALL PRIVILEGES and click Make Changes.

Open Node.js App Manager

Go back to cPanel home → click Setup Node.js App.

Create Application

Click CREATE APPLICATION.

Fill out the form

Configure the application with these settings:

• Node.js version: 18 or higher
• Application mode: Production
• Application root: path to your WebPanel folder (e.g. bouflix/WebPanel)
• Application URL: your domain/subdomain
• Application startup file: app.js

Click CREATE.

Run NPM Install

After creating the application, click Run NPM Install and wait for the dependencies to install.

Open your panel URL

Open the application URL in your browser. You'll be automatically redirected to the Setup Wizard.

Fill the database form & Install

Enter your MySQL credentials from Part 3 and set your admin email/password, then click Install Bouflix.

• Host: localhost
• Port: 3306
• Database Name: your database name
• Database Username: your database user
• Database Password: your database password
• Admin Email: your admin email
• Admin Password: your desired password

Sign in

After the automatic restart, you'll see the login page. Sign in with the admin email and password you created in Step 20.

Enter your license & package name

After login, you'll be redirected to the License Activation page. Enter:

• Envato Purchase Code: Your CodeCanyon purchase code (find it in CodeCanyon → Downloads → License certificate)
• Android Package Name: Your app's package name from build.gradle.kts (e.g. com.bouflix.app)

Click Activate License.

Done! 🎉

You're now in the Bouflix Admin Panel dashboard. Your panel is fully set up and ready to use!

Install Node.js

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
node -v  # should show v20.x

Upload & Install

# Upload files via SCP/SFTP to /var/www/bouflix-panel
cd /var/www/bouflix-panel
npm install

Configure .env & Setup DB

cp .env.example .env
nano .env   # Fill in your credentials
npm run setup
npm run create-admin

Build Production

npm run build

Install PM2 & Start

sudo npm install -g pm2
pm2 start app.js --name bouflix-panel
pm2 save
pm2 startup  # auto-start on reboot

Nginx Reverse Proxy

sudo nano /etc/nginx/sites-available/bouflix

# Paste this config:
server {
    listen 80;
    server_name panel.yoursite.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_cache_bypass $http_upgrade;
    }
}

sudo ln -s /etc/nginx/sites-available/bouflix /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

SSL Certificate (Let's Encrypt)

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d panel.yoursite.com

Push to Git

Push the Admin Panel to a GitHub/GitLab repository (exclude node_modules, .next, .env).

Import on Vercel

Go to vercel.com/new → Import your repo → Select the Admin Panel directory as root.

Environment Variables

In Vercel project settings → Environment Variables, add all variables from the .env configuration section.

Deploy

Vercel builds automatically. After deployment, run the setup commands via Vercel CLI or connect to your DB manually and run:

npx prisma db push --accept-data-loss
node create-admin.js

Open your panel URL

Navigate to your panel URL in a browser. The Setup Wizard will appear automatically if the database hasn't been configured yet.

Database & Admin Setup

The wizard will ask for your MySQL credentials and let you create an admin account — all from the browser. No SSH or terminal needed.

Login & Activate License

After setup, log in with your admin credentials. You'll be prompted to enter your CodeCanyon purchase code and Android package name to activate the license.

Post-Deploy Checklist

• ✅ Go to Settings → API Keys and add your TMDB API key
• ✅ Add your first movie or TV show from Content
• ✅ Configure Slideshow for the app home screen
• ✅ Set up Embed Sources for streaming
• ✅ Configure V1_HMAC_SECRET in Settings for mobile app API security

Open the Project

Open the bouflix-Android Source folder in Android Studio. Wait for Gradle sync to complete.

Gradle Sync

If prompted, accept SDK licenses. Let Android Studio download all dependencies (first time may take 5-10 minutes).

Open build.gradle.kts

In Android Studio, open app/build.gradle.kts. You'll see the default package name com.bouflix.app in both the namespace and applicationId fields.

Rename the package folder

In the Project panel (left side), expand app → src → main → java → com. Right-click the bouflix folder → Refactor → Rename.

Enter the new name

In the Rename dialog, type your new company/app name (e.g. bouflix1, netfinity, etc.). Make sure "Search for text occurrences" is checked, then click Refactor.

Review and apply refactoring

Android Studio will show a Refactoring Preview with all affected files (imports, package declarations, references, etc.). Review the changes, then click Do Refactor.

Update namespace & applicationId

After the refactor, open app/build.gradle.kts and verify that both values match your new package name:

android {
    namespace = "com.yourcompany.app"  // ← Must match your new package
    ...
    defaultConfig {
        applicationId = "com.yourcompany.app"  // ← Must match your new package
        ...
    }
}

If Android Studio didn't update them automatically, change them manually.

Set your Admin Panel URL

In the same build.gradle.kts file, scroll down to the Buyer Configuration section and set ADMIN_PANEL_URL to your deployed admin panel URL:

buildConfigField("String", "ADMIN_PANEL_URL", "\"https://your-panel-url.com/\"")

Update google-services.json & Rebuild

You must re-download google-services.json from Firebase after changing the package name (see Firebase Setup section).

Then rebuild the project:

Build → Clean Project
Build → Rebuild Project

Create Firebase Project

Go to Firebase Console → Add Project → Name it (e.g., "MyStreamApp").

Add Android App

Click Add App → Android. Enter your new package name (e.g., com.yourcompany.yourapp).

SHA-1 Certificate

Required for Google Sign-In. Get it from Android Studio:

Gradle panel (right side) → app → Tasks → android → signingReport

Copy the SHA-1 value and paste it in Firebase.

Download google-services.json

Download the file and replace the existing one at:

app/google-services.json

Enable Authentication

In Firebase Console → Authentication → Sign-in method:

• Enable Email/Password
• Enable Google (add your Web Client ID)

Change App Name

Open app/src/main/res/values/strings.xml and change:

<string name="app_name">YourAppName</string>

Replace App Icon

Right-click res → New → Image Asset. Select your icon image (512×512 recommended). Android Studio generates all density variants automatically.

Splash Screen

The splash uses Android 12+ Splash API. Customize in res/values/themes.xml under Theme.Bouflix: change windowSplashScreenBackground and windowSplashScreenAnimatedIcon.

AdMob App ID

The only thing you need to update in the app code is the AdMob App ID in AndroidManifest.xml:

<meta-data
    android:name="com.google.android.gms.ads.APPLICATION_ID"
    android:value="ca-app-pub-XXXXXXXXXXXXXXXX~XXXXXXXXXX" />

Replace with your real AdMob App ID from admob.google.com.

Configure in Dashboard

Go to Admin Panel → Settings → Ads to set up:

• Banner, Interstitial, Rewarded ad unit IDs
• AppLovin MAX SDK Key & Unit IDs
• Meta Audience Network Placement IDs
• Ad frequency and placement rules

Create Subscriptions in Play Console

In Google Play Console → Your App → Monetize → Products → Subscriptions. Create your plans (e.g., monthly, yearly) matching the plan IDs configured in the Admin Panel.

Configure in Admin Panel

Go to Settings → Subscriptions in the admin dashboard and set up matching plan IDs, prices, and features.

In Android Studio: Build → Build Bundle(s) / APK(s) → Build APK(s)

Output: app/build/outputs/apk/debug/app-debug.apk

Generate Signing Key

In Android Studio: Build → Generate Signed Bundle / APK → Create new keystore:

• Choose a safe location for the .jks file
• Set a strong password
• Fill in the certificate details

Build Release

Select APK or Android App Bundle (AAB) (recommended for Play Store). Choose release build variant.

Output locations:

APK: app/build/outputs/apk/release/app-release.apk
AAB: app/build/outputs/bundle/release/app-release.aab

Click "Add Movie" → Search by TMDB title or ID → Select → The movie metadata (poster, overview, genres, etc.) is auto-filled from TMDB.

Add Streams — click the streams tab and add direct video URLs or embed sources with quality/language tags.

Toggle Active to make it visible in the app.

Go to Settings → Sources

Add a source with:

• Name: Display name
• Movie URL: URL template with {tmdbId} placeholder
• TV URL: URL template with {tmdbId}, {season}, {episode} placeholders

Drag & drop to reorder. The app tries sources in order until one works.