{"id":61,"date":"2013-07-17T09:07:18","date_gmt":"2013-07-17T08:07:18","guid":{"rendered":"https:\/\/desairem.com\/usync\/wordpress\/?p=61"},"modified":"2025-10-03T17:59:35","modified_gmt":"2025-10-03T16:59:35","slug":"synctime-custom-script-before-or-after-a-sync","status":"publish","type":"post","link":"https:\/\/desairem.com\/wordpress\/synctime-custom-script-before-or-after-a-sync\/","title":{"rendered":"Custom script before or after a sync"},"content":{"rendered":"\n

For each sync item you can define whether your Mac should send an email, a Slack message, quit SyncTime, go to Sleep, shut down or execute an arbitrary script after the sync has completed. You can also define a script to run before the sync starts. You can find these options in the Advanced tab of the sync item settings.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Alternatively, you can define a script that will be executed once after all syncs have completed, either from the status item menu, the File menu or the main window context menu. This general script is executed only once and then reset to the default No custom script<\/em>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Tip<\/strong>: if you want to execute a script every time<\/em> all syncs have completed, at the beginning of the script you can send a command to set the script again. For additional help, see Control SyncTime with AppleScript<\/a>.<\/p>\n\n\n\n

Install predefined script<\/h2>\n\n\n\n

SyncTime offers some predefined scripts that you can automatically install in your user scripts directory. macOS only allows scripts inside this directory to be executed. You can also create your own scripts (see below), or edit the installed scripts.<\/p>\n\n\n\n

Note<\/strong>: the predefined scripts are designed to work only when the sync completes, not before the sync starts.<\/p>\n\n\n\n

    \n
  1. Open the Edit scripts<\/em> window, either from the status item menu or the main window context menu by selecting Once All Syncs Are Completed > Edit Scripts<\/em>.<\/li>\n\n\n\n
  2. Click the Download button beside the desired script. You can choose any of the following predefined scripts:\n
      \n
    • Play sound<\/li>\n\n\n\n
    • Quit SyncTime<\/li>\n\n\n\n
    • Send email<\/li>\n\n\n\n
    • Send Slack message<\/li>\n\n\n\n
    • Shut down<\/li>\n\n\n\n
    • Sleep<\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • Click Install.<\/li>\n\n\n\n
    • Close the Edit scripts<\/em> window. An item corresponding to the new script is now available throughout the app.<\/li>\n<\/ol>\n\n\n\n
      \"\"<\/figure>\n\n\n\n

      Install custom script<\/h2>\n\n\n\n

      If you cannot find a predefined script that satisfies your needs, you can write your own script.<\/p>\n\n\n\n

        \n
      1. Open the AppleScript Editor (located in \/Applications\/Utilities<\/code>).<\/li>\n\n\n\n
      2. Create a new document. You can start populating it by pasting one of the codes given below.<\/li>\n\n\n\n
      3. Save the document on the Desktop with a meaningful name.<\/li>\n\n\n\n
      4. Open the Edit scripts<\/em> window in SyncTime, either from the status item menu or the main window context menu by selecting Once All Syncs Are Completed > Edit Scripts<\/em><\/em>. Then click on Show Scripts Directory in Finder<\/em>. (The scripts directory is located at \/Users\/yourusername\/Library\/Application Scripts\/org.desairem.uSync<\/code>.) Drag the newly created file into this directory.<\/li>\n\n\n\n
      5. Close the Edit Scripts<\/em> window in SyncTime. An item corresponding to the new file\u00a0is now available throughout the app.<\/li>\n<\/ol>\n\n\n\n

        Codes<\/h3>\n\n\n\n

        If you’re writing a script to run before a sync starts<\/strong> and want to include some information about the sync, write your code inside a handler with the following signature:<\/p>\n\n\n\n

        on syncStart(syncItem)\n    ...\nend syncStart<\/code><\/pre>\n\n\n\n
        If you’re writing a script to run after a sync completes<\/strong> and want to include some information about the sync, write your code inside a handler with the following signature:<\/p>\n\n\n\n
        on syncCompleted(syncItem, stateCode, stateLabel, scheduleLabel)\n    ...\nend syncCompleted<\/code><\/pre>\n\n\n\n
        Sleep<\/h4>\n\n\n\n
        tell application \"System Events\" to sleep<\/code><\/pre>\n\n\n\n
        Shut down<\/h4>\n\n\n\n
        tell application \"System Events\" to shut down<\/code><\/pre>\n\n\n\n
        Play a sound with a given filename<\/h4>\n\n\n\n
        You may store your custom sounds as well in \/Users\/yourusername\/Library\/Application Scripts\/org.desairem.uSync<\/code><\/p>\n\n\n\n
        do shell script \"afplay \/System\/Library\/Sounds\/Glass.aiff\"<\/code><\/pre>\n\n\n\n
        Play a random system sound<\/h4>\n\n\n\n
        do shell script \"afplay \/System\/Library\/Sounds\/\" & some item of paragraphs of ((do shell script \"ls \/System\/Library\/Sounds\/\"))<\/code><\/pre>\n\n\n\n
        Quit SyncTime<\/h4>\n\n\n\n
        tell application \"SyncTime\" to quit<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
        For each sync item you can define whether your Mac should send an email, a Slack message, quit SyncTime, go to Sleep, shut down or execute an arbitrary script after the sync has completed. You can also define a script to run before the sync starts. You can find these options in the Advanced tab […]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"wp-custom-template-sync-time-help-post","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-61","post","type-post","status-publish","format-standard","hentry","category-synctime-help"],"_links":{"self":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/61","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/comments?post=61"}],"version-history":[{"count":65,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/61\/revisions"}],"predecessor-version":[{"id":5212,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/posts\/61\/revisions\/5212"}],"wp:attachment":[{"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/media?parent=61"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/categories?post=61"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/desairem.com\/wordpress\/wp-json\/wp\/v2\/tags?post=61"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}