π 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.
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
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:
[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]
- [VIDEOS/METADATA/ACTIONS]
topics_shuffle
Determines the order of topic usage:
True: topics are shuffled randomlyFalse: 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 activeFalse: 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.
*_shuffle parameters determine whether to shuffle corresponding data within each topic during initial loading:
Configuration sections:
- [VIDEOS]: settings for video files and thumbnails
- [METADATA]: settings for titles, descriptions and keywords
- [ACTIONS]: settings for comments, end screens and info cards
Shuffle principle:
True: data is shuffled once when the topic is loadedFalse: data remains in original order (alphabetical for files, line order for text)
Optimization: Shuffle is performed only when loading topic into memory. During auto-refresh, data is already shuffled.
Settings in Program Interfaceβ
Template settings in the program provide two configuration levels:
How to Enable Topics Modeβ
- Open the Video Upload Configuration tab in the input settings.
- Select
Topicsin Thread Operation Mode. - Use the Files data source. Scheduler is not used with
Topicsmode. - 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 Setting | Description | Features |
|---|---|---|
| Upload videos | Use video files | Always enabled |
| Upload thumbnail | Use thumbnails | Can be disabled |
| Rename video | Use titles | Can be disabled |
| Fill description | Use descriptions | Can be disabled |
| Fill tags | Use keywords | Can be disabled |
| Publish comment | Use comments | Can be disabled |
| Set like | Use likes | Fixed value |
| Add end screen | Use end screens | Can be disabled |
| Add info card | Use info cards | Can be disabled |
Data Extraction Orderβ
Parameters determining the selection method for each element from the list:
| Program Setting | Description | Values |
|---|---|---|
| Video order | Order of video file selection | "In order" / "Random" |
| Thumbnail order | Order of thumbnail selection | "In order" / "Random" |
| Title order | Order of title selection | "In order" / "Random" |
| Description order | Order of description selection | "In order" / "Random" |
| Tag order | Order of keyword selection | "In order" / "Random" |
| Comment order | Order of comment selection | "In order" / "Random" |
| End screen order | Order of end screen selection | "In order" / "Random" |
| Info card order | Order of info card selection | "In order" / "Random" |
- 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:
- The corresponding checkbox in the program is verified (global setting)
- The existence and content of files in the topic are verified
- Availability is set automatically for each video
Example:
- "Rename video" disabled β titles never used
- "Rename video" enabled + no
3_Titles.txtfile β 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β
- Use pre-installed folder in project directory:
..\YouTube-Uploader\[Topics] - 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:
- Create the required
1_Videosfolder and place video files there - If needed, create a
2_Thumbnailsfolder for thumbnails - If needed, create text files with the corresponding data
Step 3: Configure Settingsβ
- Create
config.inifile in..\YouTube-Uploader\[Topics]\folder - Set the parameter values you need
- Save the file
Step 4: Program Setupβ
- Configure data usage checkboxes (Upload thumbnail, Rename video, etc.)
- Configure data extraction order parameters (Video order, Title order, etc.)
- 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β
- Missing
1_Videosfolder - No video files in
1_Videosfolder - Incorrect folder access permissions
Solution: check the folder structure and that video files are present.
Data Not Shufflingβ
*_shuffle=Falseset inconfig.ini- Syntax error in
config.inifile - Insufficient data for noticeable effect
Solution: check the shuffle settings in config.ini.
Some Data Types Not Usedβ
- 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β
- Incorrect
topics_refreshsettings - 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:
- Global setting: if the corresponding checkbox is disabled, the data is not used at all
- File presence: if the checkbox is enabled but the files are missing, an empty value is returned
- File content: if the files exist but are empty, an empty value is returned
- 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_refreshsetting - With
topics_refresh=truethey are restored like cyclical data - With
topics_refresh=falsethe 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.