Smos Logo Smos

A comprehensive self-management system

The Smos Calendar Import Tool

Documentation for the Smos Calendar Import Tool, for importing your calendar into Smos

This tool exists to import your calendar from an external source into Smos.

Make sure to run it periodically.

Note that you can also ignore specific events while importing, by adding SMOS_NO_CALENDAR_IMPORT to their description.

See the instructions for running it on NixOS for automation for that on NixOS.

Reference

Arguments

Usage: smos-calendar-import [--config-file FILE_PATH] 
                            [--workflow-dir DIRECTORY_PATH] 
                            [--archive-dir DIRECTORY_PATH] 
                            [--projects-dir DIRECTORY_PATH] 
                            [--archived-projects-dir DIRECTORY_PATHPATH] 
                            [--log-level ARG] [--debug]

  
  Smos Calendar Import Tool version: 0.8.2
  
  Current Smos data format version: 2.0.0

Available options:
  -h,--help                Show this help text
  --config-file FILE_PATH  The config file to use
  --workflow-dir DIRECTORY_PATH
                           The workflow directory to use
  --archive-dir DIRECTORY_PATH
                           The archive directory to use
  --projects-dir DIRECTORY_PATH
                           The projects directory to use
  --archived-projects-dir DIRECTORY_PATHPATH
                           The archived projects directory to use
  --log-level ARG          The log level to use, options:
                           ["Debug","Info","Warn","Error"]
  --debug                  Turn on debug output

Environment

Available environment variables:

  SMOS_ARCHIVED_PROJECTS_DIR
                         Archived projects directory
  SMOS_ARCHIVE_DIR
                         Archive directory
  SMOS_CONFIG_FILE
                         Workflow directory
  SMOS_DEBUG             Whether to output debug info
  SMOS_LOG_LEVEL         The minimal severity of log
                         messages
  SMOS_PROJECTS_DIR
                         Projects directory
  SMOS_WORKFLOW_DIR
                         Workflow directory

Configuration

# Configuration
workflow-dir: # optional
  # The workflow directory
  # or null
  <string>
archive-dir: # optional
  # The archive directory
  # or null
  <string>
projects-dir: # optional
  # The projects directory
  # or null
  <string>
archived-projects-dir: # optional
  # The archived projects directory
  # or null
  <string>
calendar: # optional
  # Calendar configuration
  # or null
  # CalendarImportConfiguration
  sources: # optional
    # default: []
    # The sources to import from
    # or null
    - # SourceConfiguration
      name: # optional
        # The name of the source
        # or null
        <string>
      source: # optional
        # the url to fetch or file to import
        # or null
        # If you are using Google, you want to get the URL that has these labels:
        # "Use this address to access this calendar from other applications without making it public."
        # "Warning: Only share this address with those you trust to see all event details for this calendar."
        # For more info, see https://support.google.com/calendar/answer/37648?hl=en#zippy=%2Cget-your-calendar-view-only.
        <string>
      source-file: # optional
        # the file that contains the url to fetch or file to import
        # or null
        <string>
      destination: # required
        # The destination path within the workflow directory
        <string>
  log-level: # optional
    # Minimal severity of error messages
    # or null
    def: LogLevel
    # The log level to use, options:
    # ["Debug","Info","Warn","Error"]
    <string>
  debug: # optional
    # Show the internal structure of every event in its entry's contents.
    # or null
    <boolean>