Quick installation of CloudBook 2.0

1. Introduction

Welcome to the activator manual. As a registered activator, you are responsible for logging all QSOs made during the activity from the assigned stations or references.

2. Access & Credentials

To access as an activator:

1. Click the Login button in the top bar
2. Enter your callsign (e.g., EA1ABC)
3. Enter your password
4. Press Enter to validate

3. QSO Form

The form is designed for rapid data entry during pile-ups. It is optimized for keyboard use:

• Autofocus: Upon loading, the cursor is in the "Callsign" field
• Auto-uppercase: The callsign is converted to uppercase as you type
• Real-time validation: Immediate warning if the QSO is duplicate or incorrect
• Smart Signal: Automatically switches between 59/599/00 based on mode

4. Fields Explained

5. CB vs Ham Radio

The system automatically distinguishes the station type:

6. References

References identify the special station or location from which you are activating (castles, lighthouses, summits, events...). The organization configures the system from the Tasks panel with these options:

7. Duplicate Detection

While typing a callsign, the system displays a floating toast if it detects previous QSOs with that station:

• Exact search: Only shows matches for the exact same callsign
• Detailed info: Date, time, mode, band, and signal of each previous QSO
• Quick close: Press Tab or Enter to close the notice

8. Keyboard Shortcuts

9. REST API for External Applications

The system exposes a REST API that allows uploading QSOs from external logging applications (GRGDesktop, N1MM, Logger32, Swisslog, mobile apps, custom scripts, etc.) without using the web form.

Endpoint

⚠️ About the "activator" field

Request Parameters

All parameters are sent via query string (URL). They are mandatory unless stated otherwise:

Complete Request Example

GET /api_qso.php?usuario=EA1ABC&password=MyPassword123&indicativo=EA4XYZ&banda=20M&modo=SSB&fecha=2026-06-04&hora=14:30&senal=59&referencia=CCE-001

Successful Response Example (HTTP 201)

{
    "success": true,
    "message": "QSO registered correctly.",
    "data": {
        "id": 1542,
        "indicativo": "EA4XYZ",
        "banda": "20M",
        "modo": "SSB",
        "fecha": "2026-06-04",
        "hora": "14:30",
        "senal": "59",
        "activador": "EA1ABC",
        "dxcc": 281,
        "pais": "Spain",
        "continente": "EU",
        "referencia": "CCE-001",
        "unix": 1780487400
    }
}

⚠️ Using references in external programs

In most logging programs (GRGDesktop, N1MM, Logger32, Ham Radio Deluxe, etc.), the reference field does not exist. To send the reference from these programs, you must use the comments field (comment) of the QSO and write the valid reference exactly there.

💡 Important Notes

• Date/Time in UTC: Ensure your software sends time in UTC, not local time
• No Cache: Each request is processed in real-time, no processing queue
• Automatic Fields: The system automatically calculates dxcc, pais, continente, and unix. No need to send them
• Automatic Activator: Always taken from authenticated user (usuario), cannot be spoofed
• Duplicate Detection: The API blocks duplicate QSOs with callsign+date+time+mode+band combination
• Future Dates Blocked: Cannot upload QSOs with date/time later than current moment

10. Bulk ADIF Log Upload

If you prefer to log QSOs in your usual logging software (GRGDesktop, N1MM, Logger32, Swisslog, etc.) and upload them at the end of the day, you can do so by importing the log in ADIF format (.adi or .adif).

Step-by-step Process

1. Access the menu Tasks → Upload ADIF Log
2. Export your log from the external program in ADIF format
3. Select the generated .adi file
4. Click Upload and wait for processing
5. The system will show a summary: QSOs added, duplicates, and rejected

⚠️ References in ADIF files

ADIF does not have a specific field for references. For QSOs to be valid, the reference must be saved in the comments field (<COMMENT>) of the ADIF. The reference must be written exactly as in the official list.

Example of ADIF QSO with valid reference

<CALL:6>EA4ABC <BAND:3>20M <MODE:3>SSB <QSO_DATE:8>20260604 <TIME_ON:4>1430 <RST_SENT:2>59 <COMMENT:7>CCE-033 <EOR>

Processing Result

11. Why are some QSOs not loaded?

The system applies automatic validations to maintain log integrity.

Most common reasons for rejection

• Duplicate: A QSO already exists with same callsign, date, time, mode, band
• Incorrect Band: CB on band other than 11M, or Ham on 11M
• Empty Mode
• Date out of range
• Invalid ADIF Format
• Invalid Callsign

12. QSO Table

Below the form you will see your last 25 QSOs in real-time, with auto-update every 15 seconds and quick edit option.

13. Homepage Statistics and Charts

The activity's main page displays real-time statistics, counters, and charts: Total QSOs, DXCC Worked, 11M Divisions, charts for modes, bands, continents, QSOs by activator, references, time evolution (7d/15d/30d/60d/90d), and OnAir panel with live stations.

14. Curiosities and Tricks

15. Frequently Asked Questions

1. Introduction

Welcome to the activity! As a participant, you can consult the public log, search for your QSOs, and, if you meet the objectives, directly download your diploma or QSL without needing to wait for the activity to end or send requests.

2. How to Participate

1. Listen to special stations on the indicated bands
2. Contact them indicating your callsign and signal
3. Wait for the activator to upload the QSO to the system (usually a few minutes)
4. Verify in the public log that your QSO is registered
5. Download your diploma or QSL as soon as you reach the objectives

3. View Public Log

The log is available from the main menu. You will see a table with all registered QSOs: callsign, date/time, mode/band, signal, activator, reference.

4. Search Your Callsign

Use the search engine on the main page to find all QSOs with your callsign. The search is exact. On your results page you will see the current progress towards diploma/QSL objectives, and if you have met them, a download button will appear.

5. Diplomas and QSL

Depending on the activity, you can obtain diplomas (personalized digital document) and QSL (confirmation card). No need to request them or wait for the activity to end. As soon as your log meets the objectives, the download button will activate automatically.

6. Common Bands and Modes

Common modes: SSB (voice), CW (Morse code), FT8/FT4 (digital), AM/FM.

7. Special References

References identify special stations or places (castles, lighthouses, parks, summits, etc.). Only references appearing in the activity's official list count as valid.

8. Rankings

Some activities include rankings by number of QSOs, references, DXCC, or bands.

9. Homepage Statistics and Charts (for participants)

The main page shows real-time charts: modes, bands, continents, QSOs by activator, references, time evolution, and the OnAir panel with stations currently transmitting. Use this data to plan your strategy and know when and where it's easier to contact.

10. Curiosities

• All times are in UTC.
• DXCC is the code that identifies each entity (country or territory) for radio purposes.
• Propagation conditions change according to the solar cycle (11 years). We are near the maximum of cycle 25 (2024-2026).
• This system allows downloading diplomas and QSLs in real-time, without waiting.

11. Frequently Asked Questions (Participant)

16. Administration Panel

Access from Tasks to configure the system, manage users, QSL and diplomas.

17. System Configuration

From Tasks → Configuration you manage global parameters: database, activity dates, valid bands, copyright, and administrator email.

🗄️ Database Configuration

Fields: Server, DB Name, User, Password.

📅 Activity Dates and Bands

Start Date, End Date, Activity Bands (comma-separated, e.g., 40M, 20M, 11M).

📜 Footer Information

Copyright text, Copyright URL, Administrator Email.

18. User Management

Create, edit, and delete activators. Assign passwords and permissions (standard activator or administrator).

Create a new activator

1. Access Tasks → User Management
2. Click New User
3. Fill in: Callsign, Password, Email (optional), Permissions
4. Save

19. Configure QSL

Enable QSL, define valid references, and design the template with live preview: background image, size (A4/A5), orientation, customizable fields (callsign, date, time, band, mode, RST), typography, and additional HTML comment.

20. Configure Diploma

Enable diploma, objectives (1 QSO per day/band/mode/reference), minimum QSOs, reference list, and design the template with fields: callsign, name, date/place. Live preview available.

21. Technical Glossary

Main tables: usuarios, log, dxcc, divisiones, prefijos, configuracion_qsl, diploma.

The objective validation algorithm is greedy: sorts QSOs by descending date and counts each dimension (day, band, mode, reference) only once.