4d10db4f17
PHP 8.4 library and CLI tools to read, modify, and generate ProPresenter 7 files: songs (.pro), playlists (.proplaylist), bundles (.probundle), themes, and the global library files (Macros, Labels, Groups, ClearGroups, CCLI, Messages, Timers, Stage, Workspace, Props, TestPatterns, Calendar, KeyMappings, CommunicationDevices). Built on the MIT-licensed ProPresenter7-Proto schema by greyshirtguy (v7.16.2). Includes 18 CLI parsers, comprehensive API docs in doc/, binary-format specs, and a synthetic 369-test PHPUnit suite covering RTF extraction, translation slides, ZIP64 repair, round-trip fidelity, and end-to-end generation.
52 lines
1.8 KiB
Protocol Buffer
52 lines
1.8 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package rv.data;
|
|
|
|
option cc_enable_arenas = true;
|
|
option csharp_namespace = "Pro.SerializationInterop.RVProtoData";
|
|
option swift_prefix = "RVData_";
|
|
|
|
import "rvtimestamp.proto";
|
|
import "uuid.proto";
|
|
|
|
// CalendarDocument is the global ProPresenter `Calendar` file. It holds
|
|
// scheduled events that fire macros at given times. The exact semantics of
|
|
// the inner sub-messages 8 and 9 (action and embedded macro reference) are
|
|
// preserved as raw bytes so the document round-trips byte-for-byte; clients
|
|
// that need to inspect them can decode them with `protoc --decode_raw` or
|
|
// reach for the raw protobuf message.
|
|
message CalendarDocument {
|
|
message Event {
|
|
// Stable identity of this calendar event.
|
|
.rv.data.UUID uuid = 1;
|
|
|
|
// Display name (e.g. "Doors Open").
|
|
string name = 2;
|
|
|
|
// When the event starts. Stored as Timestamp seconds (and optional nanos).
|
|
.rv.data.Timestamp start_time = 4;
|
|
|
|
// Opaque flags blob observed in samples. Often a single byte (e.g. 0x01)
|
|
// that ProPresenter uses for recurrence or visibility state.
|
|
bytes flags = 5;
|
|
|
|
// When the event ends. Optional. Same format as `start_time`.
|
|
.rv.data.Timestamp end_time = 6;
|
|
|
|
// Action that runs when the event fires. Encoded as raw protobuf bytes
|
|
// (a `rv.data.Action`-shaped message) so the schema can evolve without
|
|
// breaking existing clients.
|
|
bytes action_data = 8;
|
|
|
|
// Embedded copy of the macro definition the event triggers. Stored as
|
|
// raw protobuf bytes (shape compatible with `MacrosDocument.Macro`).
|
|
bytes macro_data = 9;
|
|
}
|
|
|
|
// Events scheduled in the calendar, in the order ProPresenter wrote them.
|
|
repeated Event events = 1;
|
|
|
|
// Source / mode flag observed in samples (value `1`). Treated as opaque.
|
|
uint32 mode = 2;
|
|
}
|