Software Guide

About 1417 wordsAbout 5 min

2026-01-24 22:55:00

Welcome to SecRandom! When you launch the software for the first time, the setup wizard will help you complete the initial configuration. This guide will provide detailed instructions for each step of the setup process.

Guide Overview

The software setup includes the following 9 pages. Complete them in order to finish the initial software configuration:

Page	Content	Estimated Time
Welcome Page	Display app logo and title	10 seconds
Language Selection Page	Select application language	30 seconds
License Agreement Page	Agree to license agreement and disclaimer	1 minute
Data Migration Page	Import old data (optional)	2 minutes
Basic Settings Page	Simplified mode, theme, theme color	1 minute
List Management Page	Student list, class management	5 minutes
Enhanced Features Page	TTS, music, ClassIsland integration	3 minutes
Test Page	Test various features	2 minutes
Links Page	Complete setup, view related links	30 seconds

Tip

Completing the entire setup process takes approximately 15-20 minutes. Data migration and list management are optional steps that you can skip and complete later in settings.

Welcome Page

Page Content

Displays SecRandom logo and title
Simple welcome interface

Operation Steps

Click the "Start" button to proceed to the next step.

Language Selection Page

Page Content

Provides multiple language options
Language change requires restarting the application to take effect

Operation Steps

Select your preferred language from the dropdown list (e.g., "中文", "English")
Click "Next" to continue

Note

Language changes require restarting the application to take effect.

License Agreement Page

Page Content

Contains two tabs:

License Agreement: Displays GPL license agreement
Disclaimer: Displays software disclaimer

Operation Steps

Read Agreement: Switch between the two tabs and read the agreement content completely
Scroll to Bottom: Must scroll to the bottom of the agreement to check the agreement option
Check Agreement:
- Agree to License Agreement
- Agree to Disclaimer
Click "Next" to continue

Must Agree

You must check both "Agree to License Agreement" and "Agree to Disclaimer" to proceed to the next step.

Data Migration Page

Page Content

Provides manual import of old data functionality
If you have used SecRandom before, you can import data from the old version

Operation Steps

If You Need to Import Data

Click the "Import" button
Select the old version data file
Wait for the import to complete
Import successfully and automatically jump to the last page

If You Do Not Need to Import Data

Click "Next" to skip this step directly.

Optional Step

Data migration is an optional step. If you are using it for the first time or do not need to import old data, you can skip this step.

Basic Settings Page

Page Content

Configure the basic appearance and behavior settings of the software.

Operation Steps

Simplified Mode

On: Hide advanced functions, simpler interface
Off: Show all functions, suitable for advanced users
Recommended: Recommended to turn off for first-time use to understand all functions

Theme Settings

Select interface theme:

Option	Description
Light	Light theme, suitable for daytime use
Dark	Dark theme, suitable for night use, eye protection
Follow System	Automatically follow system theme settings

Theme Color

Choose your favorite theme color to customize the software appearance.

Suggestion

It is recommended to select the "Follow System" theme, so that the software will automatically switch between light/dark modes according to system settings.

List Management Page

Page Content

Manage student lists and class information.

Operation Steps

Create Class

Enter class name (e.g., "Grade 1 (3)")
Click "Create" button

Import Student List

Method 1: Manual Input

Enter student names line by line
Optional: Enter gender, group information

Method 2: Excel Batch Import (Recommended)

Excel Table Format:
| Student ID | Name | Gender | Group |
|------------|------|--------|-------|
| 01         | John | Male   | A     |
| 02         | Jane | Female | B     |

Operation Steps:

Prepare Excel table, ensure the first row is column names
Click "Import" button
Select Excel file
System automatically identifies column names and imports data

Create Prize Pool (Optional)

Switch to Lottery Mode
Enter prize pool name (e.g., "Final Exam Prizes")
Enter prize names line by line
Set prize weights (higher weight means higher probability of winning)

Optional Step

List management is an optional step. You can continue configuring it later in settings.

Enhanced Features Page

Page Content

Contains three tabs to configure enhanced features of the software.

Operation Steps

Tab 1: TTS Settings

Configure text-to-speech function:

Setting	Description
Voice Engine	Select TTS voice engine
Edge TTS Voice Name	Select specific voice (e.g., "Microsoft Xiaoxiao Online")
Volume	Adjust voice volume
Speed	Adjust voice playback speed

Tab 2: Music Settings

Configure background music:

Setting	Description
Animation Music	Music played during drawing animation
Result Music	Music played when drawing result is displayed
Music Volume	Adjust music volume
Fade In/Out	Set music fade in/out effect

Tab 3: ClassIsland Integration

Configure integration with ClassIsland:

Setting	Description
Data Source Settings	Configure ClassIsland data source
CSes Import	Import ClassIsland course data
Notification Service	Set notification service type (0=Off, 1/2=On)
Dismiss Bell	Configure dismiss bell function

Optional Step

Enhanced features are optional steps. You can continue configuring them later in settings.

Test Page

Page Content

Test if the features you configured are working properly.

Operation Steps

Test TTS Voice

Click "Test Voice" button
Listen if voice broadcast is normal
If there is a problem, return to the previous step to adjust settings

Test Music Playback

Click "Test Animation Music" button
Click "Test Result Music" button
Check if music plays normally
If there is a problem, return to the previous step to adjust settings

Test ClassIsland Integration

Click "Test Integration" button
Check if connection with ClassIsland is normal
If there is a problem, return to the previous step to adjust settings

Suggestion

It is recommended to test all functions to ensure correct configuration before continuing.

Links Page

Page Content

Provides related links for you to get more information and support.

Operation Steps

View Links

Link	Description
GitHub	View source code and submit issues
Bilibili	Watch video tutorials
Documentation	View detailed documentation
Organization Site	Learn about organization info
Feedback	Submit feedback

Complete Setup

Click "Finish" button to end the setup process.

Setup Completed

After setup is complete, the software will remember your configuration. If you need to reconfigure, you can find relevant options in settings.

Congratulations on Completing Setup!

You have completed the initial configuration of SecRandom! You can now start using the software.

Quick Start

Action	Shortcut
Random Roll Call	Right-click tray icon → "Roll Call"
Random Lottery	Right-click tray icon → "Lottery"
View History	Right-click tray icon → "History"
Open Settings	Right-click tray icon → "Settings"

Next Steps

Read User Interface Introduction to learn more about interface functions
View Software Settings Tutorial to learn deeply about various settings
Explore Core Functions to unleash the full potential of the software

Need Help?

If you encounter problems during the configuration process, you can get help through the following ways:

Feedback

Your feedback is very important to us! If you have any suggestions or find problems, please feel free to tell us.

Contributors

LeafS825

Changelog

2/12/26, 2:15 PM

View All Changelog

f0574-docs(ipc_url): 新增计时器窗口命令并调整动画速度回调被本新搞坏的动画速度on 2/12/26

Copyright

License under:CC BY-NC-SA 4.0