Software Guide
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:
| Step | Page | Content | Estimated Time |
|---|---|---|---|
| 1️⃣ | Welcome Page | Display app logo and title | 10 seconds |
| 2️⃣ | Language Selection Page | Select application language | 30 seconds |
| 3️⃣ | License Agreement Page | Agree to license agreement and disclaimer | 1 minute |
| 4️⃣ | Data Migration Page | Import old data (optional) | 2 minutes |
| 5️⃣ | Basic Settings Page | Simplified mode, theme, theme color | 1 minute |
| 6️⃣ | List Management Page | Student list, class management | 5 minutes |
| 7️⃣ | Enhanced Features Page | TTS, music, ClassIsland integration | 3 minutes |
| 8️⃣ | Test Page | Test various features | 2 minutes |
| 9️⃣ | 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.
1️⃣ Welcome Page
Page Content
- Displays SecRandom logo and title
- Simple welcome interface
Operation Steps
Click the "Start" button to proceed to the next step.
2️⃣ 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.
3️⃣ 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.
4️⃣ 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
- After successful import, it will automatically jump to the last page
If You Don't Need to Import Data
Click "Next" directly to skip this step.
Optional Step
Data migration is an optional step. If you are using it for the first time or don't need to import old data, you can skip this step.
5️⃣ Basic Settings Page
Page Content
Configure the basic appearance and behavior settings of the software.
Operation Steps
1️⃣ Simplified Mode
- Enabled: Hides advanced features, simpler interface
- Disabled: Shows all features, suitable for advanced users
- Recommended: For first-time use, it's recommended to disable it to understand all features
2️⃣ Theme Settings
Select interface theme:
| Option | Description |
|---|---|
| Light | Light theme, suitable for daytime use |
| Dark | Dark theme, suitable for nighttime use, eye-friendly |
| Follow System | Automatically follows system theme settings |
3️⃣ Theme Color
Select your preferred theme color to customize the software appearance.
Suggestion
It's recommended to select "Follow System" theme, so the software will automatically switch between light/dark modes based on system settings.
6️⃣ List Management Page
Page Content
Manage student lists and class information.
Operation Steps
1️⃣ Create Class
- Enter class name (e.g., "Grade 10(3) Class")
- Click "Create" button
2️⃣ 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 | Zhang San | Male | Group A |
| 02 | Li Si | Female | Group B |Operation Steps:
- Prepare Excel table, ensure the first row contains column names
- Click "Import" button
- Select Excel file
- System automatically recognizes column names and imports data
3️⃣ Create Prize Pool (Optional)
- Switch to prize draw mode
- Enter prize pool name (e.g., "Final Term Prizes")
- Enter prize names line by line
- Set prize weights (higher weight means higher probability of being selected)
Optional Step
List management is an optional step. You can continue configuration in settings later.
7️⃣ Enhanced Features Page
Page Content
Contains three tabs to configure software enhanced features.
Operation Steps
Tab 1: TTS Settings
Configure text-to-speech functionality:
| Setting | Description |
|---|---|
| Voice Engine | Select TTS voice engine |
| Edge TTS Voice Name | Select specific voice (e.g., "Microsoft Xiaoxiao Online") |
| Volume Size | Adjust voice volume |
| Speech Rate | Adjust voice playback speed |
Tab 2: Music Settings
Configure background music:
| Setting | Description |
|---|---|
| Animation Music | Music played during extraction animation |
| Result Music | Music played when displaying extraction results |
| Music Volume | Adjust music volume |
| Fade In/Out | Set music fade in/out effects |
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) |
| End of Class Bell | Configure end of class bell functionality |
Optional Step
Enhanced features are optional steps. You can continue configuration in settings later.
8️⃣ Test Page
Page Content
Test whether your configured features are working properly.
Operation Steps
1️⃣ Test TTS Voice
- Click "Test Voice" button
- Listen to see if voice playback is normal
- If there are issues, return to the previous step to adjust settings
2️⃣ Test Music Playback
- Click "Test Animation Music" button
- Click "Test Result Music" button
- Check if music plays normally
- If there are issues, return to the previous step to adjust settings
3️⃣ Test ClassIsland Integration
- Click "Test Integration" button
- Check if connection with ClassIsland is normal
- If there are issues, return to the previous step to adjust settings
Suggestion
It's recommended to test all features to ensure configuration is correct before continuing.
9️⃣ Links Page
Page Content
Provides related links for easy access to 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 Website | Learn about organization information |
| Issue Feedback | Submit issue feedback |
Complete Setup
Click the "Finish" button to end the setup process.
Setup Complete
After completing the setup, the software will remember your configuration. If you need to reconfigure, you can find related options in settings.
🎉 Congratulations on Completing Setup!
You have completed the initial configuration of SecRandom! Now you can start using the software.
Quick Start
| Operation | Shortcut |
|---|---|
| Random Person Selection | Right-click tray icon → "Person Selection" |
| Random Prize Draw | Right-click tray icon → "Prize Draw" |
| 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 features
- ⚙️ View Software Settings Tutorial to understand each setting in depth
- 🎯 Explore Core Features to unleash the full potential of the software
🆘 Need Help?
If you encounter any issues during configuration, you can get help through the following ways:
- 📚 Check FAQ
- 💬 Join QQ Group
- 🐛 Submit GitHub Issues
Feedback
Your feedback is very important to us! If you have any suggestions or find any issues, please feel free to let us know.
Contributors
Changelog
9f919-on
Copyright
Copyright Ownership:SECTL
License under:CC BY-NC-SA 4.0