Skip to main content

πŸ“‚ Topics

What are Topics?​

Topics in YouTube-Uploader are content sorted by theme. The program does not upload videos in random order: it alternates between topics and takes the data from each topic's folder.

Definition

A topic is a set of video files, thumbnails, and text data (titles, descriptions, keywords) that share a common theme.

Working with Topics​

In topic mode the program switches between content sets on its own while uploading videos.

Key Features​

  • After each video the program switches to the next topic
  • Used data is excluded so that nothing repeats
  • The order in which data is used is configurable
  • Exhausted topics are refreshed automatically

Each topic is a separate folder with content for videos of one kind. The work goes in a loop: after using data from one topic the program switches to the next, so different types of content are spread evenly.

Benefits of Use​

🎯 Content Diversity

Uploaded videos automatically get content from different topics.

πŸ“ˆ Scalability

New topics are added without changing how the program works.

βš™οΈ Manageability

The data usage order and the topic switching logic are configurable.

πŸš€ Efficiency

Data is not reused within one cycle.

Working Principle​

The system runs continuously: it switches between topics and refreshes data when needed.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚Initialization│───►│Select current│───►│ Get data │───►│Upload video │───►│Switch to β”‚
β”‚ of topics β”‚ β”‚ topic β”‚ β”‚ β”‚ β”‚ β”‚ β”‚ next β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚Auto-refresh │◄──────────────────── NO β—„β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”β—„β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚ topics β”‚ β”‚Are there β”‚
β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜ β”‚other topics?β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
β”‚ YES β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Ίβ”˜

File and Folder Structure​

General Organization​

πŸ“ Main_topics_folder/
β”œβ”€β”€ πŸ“„ config.ini # Configuration file
β”œβ”€β”€ πŸ“ Topic_1/ # First topic
β”œβ”€β”€ πŸ“ Topic_2/ # Second topic
β”œβ”€β”€ πŸ“ Topic_N/ # N-th topic
└── ...

Structure of One Topic​

πŸ“ Topic_name/
β”œβ”€β”€ πŸ“ 1_Videos/ # βœ… REQUIRED - video files
β”‚ β”œβ”€β”€ 🎬 video1.mp4
β”‚ β”œβ”€β”€ 🎬 video2.avi
β”‚ └── ...
β”œβ”€β”€ πŸ“ 2_Thumbnails/ # βšͺ Optional - thumbnails
β”‚ β”œβ”€β”€ πŸ–ΌοΈ thumb1.jpg
β”‚ β”œβ”€β”€ πŸ–ΌοΈ thumb2.png
β”‚ └── ...
β”œβ”€β”€ πŸ“„ 3_Titles.txt # βšͺ Optional - titles
β”œβ”€β”€ πŸ“„ 4_Descriptions.txt # βšͺ Optional - descriptions
β”œβ”€β”€ πŸ“„ 5_Keywords.txt # βšͺ Optional - keywords
β”œβ”€β”€ πŸ“„ 6_Comments.txt # βšͺ Optional - comments
β”œβ”€β”€ πŸ“„ 7_EndScreens.txt # βšͺ Optional - end screens
└── πŸ“„ 8_InfoCards.txt # βšͺ Optional - info cards
Requirements

Only the 1_Videos folder with video files is required. Without it, the topic will be excluded during validation.

All other folders and files are optional: they may be missing or empty.

Supported Formats​

Video Files​

Folder: 1_Videos/
Formats: .mp4, .mpeg4, .m4v, .avi, .mov
Note: Files with other extensions are ignored

Images (Thumbnails)​

Folder: 2_Thumbnails/
Formats: .png, .jpeg, .jpg
Note: Files with other extensions are ignored

Text Data​

Format: UTF-8 text files (.txt)
Structure for most files: Each line = separate element
Exceptions: in 4_Descriptions.txt and 6_Comments.txt the entire file is one element
Note: Empty lines are automatically ignored

Example of a 3_Titles.txt file (line by line):

Exciting Review of New Technologies
Secrets of Effective Work
Masterclass for Beginners
Useful Tips from Experts

Example of a 4_Descriptions.txt file (entire file):

Welcome to my channel!
In this video we'll cover programming basics.

Subscribe and like!

πŸ”— Useful links:
- My website: example.com
- Telegram: @mychannel

#programming #education #youtube

Configuration Setup​

config.ini File​

System behavior is configured in the config.ini file. Create it in the main topics folder:

config.ini
[TOPICS]
# Shuffle topic list before loading into memory
topics_shuffle=True

# Automatically refresh data in topic after video exhaustion
# True - topic remains in queue and data is restored
# False - topic is removed from queue forever
topics_refresh=True

[VIDEOS]
# Shuffle videos in topic before loading into memory
videos_shuffle=True

# Shuffle thumbnails in topic before loading into memory
thumbnails_shuffle=True

[METADATA]
# Shuffle titles in topic before loading into memory
titles_shuffle=True

# Shuffle descriptions in topic before loading into memory
descriptions_shuffle=True

# Shuffle keywords in topic before loading into memory
keywords_shuffle=True

[ACTIONS]
# Shuffle comments in topic before loading into memory
comments_shuffle=True

# Shuffle end screens in topic before loading into memory
endscreens_shuffle=True

# Shuffle info cards in topic before loading into memory
infocards_shuffle=True

Parameter Description​

topics_shuffle

Determines the order of topic usage:

  • True: topics are shuffled randomly
  • False: topics are used in alphabetical order of folders

topics_refresh

Determines what happens to a topic when its videos run out:

  • True: when videos are exhausted, the topic refreshes automatically and stays active
  • False: when videos are exhausted, the topic is permanently removed from the queue

Important: With topics_refresh=False eventually all topics will be exhausted and the system will stop. With topics_refresh=True the system works infinitely.

Settings in Program Interface​

Template settings in the program provide two configuration levels:

How to Enable Topics Mode​

  1. Open the Video Upload Configuration tab in the input settings.
  2. Select Topics in Thread Operation Mode.
  3. Use the Files data source. Scheduler is not used with Topics mode.
  4. Fill YouTube-Uploader\[Topics] or the path assigned for topics in the template working configuration.

When Topics mode is enabled, the template takes videos and related data from topic folders instead of the regular 1_Videos.txt and 2_Thumbnails.txt files in the project root. General toggles such as Upload Thumbnail, Rename Video, Fill Description, Publish Comment, Add End Screen, and Add Info Card still determine which data types are actually used.

Data Type Usage​

Global settings that determine which data types to use at all:

Program SettingDescriptionFeatures
Upload videosUse video filesAlways enabled
Upload thumbnailUse thumbnailsCan be disabled
Rename videoUse titlesCan be disabled
Fill descriptionUse descriptionsCan be disabled
Fill tagsUse keywordsCan be disabled
Publish commentUse commentsCan be disabled
Set likeUse likesFixed value
Add end screenUse end screensCan be disabled
Add info cardUse info cardsCan be disabled

Data Extraction Order​

Parameters determining the selection method for each element from the list:

Program SettingDescriptionValues
Video orderOrder of video file selection"In order" / "Random"
Thumbnail orderOrder of thumbnail selection"In order" / "Random"
Title orderOrder of title selection"In order" / "Random"
Description orderOrder of description selection"In order" / "Random"
Tag orderOrder of keyword selection"In order" / "Random"
Comment orderOrder of comment selection"In order" / "Random"
End screen orderOrder of end screen selection"In order" / "Random"
Info card orderOrder of info card selection"In order" / "Random"
Multi-level Data Configuration
  • Global settings (checkboxes in the program) determine which data types to use at all
  • Shuffle (in config.ini) shuffles data once when the topic is loaded
  • Order (order settings) determines how each element is picked from the list

Data Usage Logic​

Behavior of Different Data Types​

🎬 Critical

Video files
  • Deleted after use
  • Determine exhaustion of the topic
  • Can auto-refresh (if topics_refresh=true)

πŸ”„ Cyclical

Titles, thumbnails, end screens, info cards
  • Deleted after use
  • Automatically restored when exhausted
  • Don't affect topic exhaustion

πŸ“Œ Permanent

Descriptions, keywords, comments
  • Remain after use
  • Used repeatedly for all videos
  • Restored when necessary

Status Flag System​

Each data type has two flags:

  • isSet*: desired setting (set by user)
  • currentIsSet*: real availability for current video

Data availability determination algorithm:

  1. The corresponding checkbox in the program is verified (global setting)
  2. The existence and content of files in the topic are verified
  3. Availability is set automatically for each video

Example:

  • "Rename video" disabled β†’ titles never used
  • "Rename video" enabled + no 3_Titles.txt file β†’ empty title returned
  • "Rename video" enabled + empty file β†’ empty title returned
  • "Rename video" enabled + file with data β†’ title from file returned

Step-by-Step Setup Guide​

Step 1: Create Folder Structure​

  1. Use pre-installed folder in project directory: ..\YouTube-Uploader\[Topics]
  2. Create folders for each topic inside:
    ..\YouTube-Uploader\[Topics]\
    β”œβ”€β”€ Adobe After Effects\
    β”œβ”€β”€ Avast Premium Security\
    └── IObit Uninstaller Pro\
    β”œβ”€β”€ Proton VPN\
    └── Wondershare Filmora\

Step 2: Fill Topics with Content​

For each topic:

  1. Create the required 1_Videos folder and place video files there
  2. If needed, create a 2_Thumbnails folder for thumbnails
  3. If needed, create text files with the corresponding data

Step 3: Configure Settings​

  1. Create config.ini file in ..\YouTube-Uploader\[Topics]\ folder
  2. Set the parameter values you need
  3. Save the file

Step 4: Program Setup​

  1. Configure data usage checkboxes (Upload thumbnail, Rename video, etc.)
  2. Configure data extraction order parameters (Video order, Title order, etc.)
  3. Start upload process

Usage Examples​

Example 1: Simple Configuration​

Structure:

MyTopics/
β”œβ”€β”€ config.ini
β”œβ”€β”€ Adobe After Effects/
β”‚ └── 1_Videos/
β”‚ β”œβ”€β”€ game1.mp4
β”‚ └── game2.mp4
└── Avast Premium Security/
└── 1_Videos/
β”œβ”€β”€ lesson1.mp4
└── lesson2.mp4

Result: the program will alternate videos from Gaming and Education.

Example 2: Extended Configuration​

Structure:

MyTopics/
β”œβ”€β”€ config.ini
β”œβ”€β”€ IObit Uninstaller Pro/
β”‚ β”œβ”€β”€ 1_Videos/
β”‚ β”œβ”€β”€ 2_Thumbnails/
β”‚ β”œβ”€β”€ 3_Titles.txt
β”‚ └── 4_Descriptions.txt
β”œβ”€β”€ Proton VPN/
β”‚ β”œβ”€β”€ 1_Videos/
β”‚ β”œβ”€β”€ 3_Titles.txt
β”‚ └── 5_Keywords.txt
└── Wondershare Filmora/
β”œβ”€β”€ 1_Videos/
└── 3_Titles.txt

Result: a full cycle with automatic switching between three topics that have different sets of data.

Best Practices​

πŸ“Š Data Balance​

  • Maintain approximately equal number of videos in different topics
  • Add more text data than videos (for description diversity)

πŸ”„ Content Management​

  • Regularly add new content so the topics stay relevant
  • Give topics meaningful names: they are easier to manage that way

πŸ§ͺ Testing​

  • Start with 1-2 topics to verify system operation
  • Gradually add new topics after debugging

πŸ“ Monitoring​

  • Track switches in the program logs
  • Check data usage from different topics

Troubleshooting​

Topic Not Loading​

Common Causes
  • Missing 1_Videos folder
  • No video files in 1_Videos folder
  • Incorrect folder access permissions

Solution: check the folder structure and that video files are present.

Data Not Shuffling​

Common Causes
  • *_shuffle=False set in config.ini
  • Syntax error in config.ini file
  • Insufficient data for noticeable effect

Solution: check the shuffle settings in config.ini.

Some Data Types Not Used​

Common Causes
  • Corresponding checkbox in program is disabled
  • Files are missing or empty
  • Incorrect file naming

Solution: check the checkbox settings in the program and that the corresponding files are present.

Topics Switching Incorrectly​

Common Causes
  • Incorrect topics_refresh settings
  • Corrupted program context

Solution: restart topic initialization.

FAQ​

Can topics be used without config.ini file?

Yes, if the file is missing, default settings will be used (all shuffle and topics_refresh parameters set to True).

What happens if a topic lacks some data types?

Verification happens on four levels:

  1. Global setting: if the corresponding checkbox is disabled, the data is not used at all
  2. File presence: if the checkbox is enabled but the files are missing, an empty value is returned
  3. File content: if the files exist but are empty, an empty value is returned
  4. Auto-refresh: cyclical data is restored from its original state

Work does not stop: the system uses the data that is available.

How does data auto-refresh work?

Cyclical data (titles, thumbnails, end screens, info cards):

  • Automatically restored from original state when exhausted
  • Restoration is instant, without re-reading files
  • Data is already shuffled according to shuffle settings

Video files:

  • Auto-refresh depends on the topics_refresh setting
  • With topics_refresh=true they are restored like cyclical data
  • With topics_refresh=false the topic is exhausted and removed from the queue

Permanent data (descriptions, comments, keywords):

  • Not deleted after use
  • Auto-refresh occurs only when necessary
What's the difference between descriptions, titles and comments?

Data structure:

  • Titles (3_Titles.txt): each line = separate title
  • Descriptions (4_Descriptions.txt): entire file = one description
  • Comments (6_Comments.txt): entire file = one comment

Usage behavior:

  • Titles are deleted after use, so they change from video to video
  • Descriptions stay the same for the entire topic
  • Comments stay the same for the entire topic
Can new topics be added during operation?

New topics will only be loaded after restarting topic initialization in the program.

How many topics can be used simultaneously?

There are no practical limitations, but for performance reasons no more than 50-100 topics is recommended.