Configure the Custom Uploader

Configure the Custom Uploader

Use the following information as a guide to configure the features of custom publishing.

Table of Contents

Description of Custom Uploading

Use Custom Uploading, rather than basic uploading, where a custom uploading API is required and when you need to create your own user interface (UI).

You can design the UI with additional controls not contained in the basic uploader. This allows the user to enter metadata through any configured web-interface control (for example, to input additional information that is uploaded with the recording).

App Display properties allow you to customize branding and message strings in the screen recorder and video editor.


The added optional input fields POST back when requesting the upload URL. For a custom upload, create a Java jar file with code that implements the Custom Publish interface.

In the jar file you create, account for:

  • Upload properties
  • Skin images
  • Other properties

The following steps outline the custom publishing process:

  1. Implement the CustomPublish Java interface class.
  2. Create a signed jar with a class that implements the CustomPublish Java interface and any additional classes created to support the upload process.
  3. Host the jar in the jarHostPath.
  4. Add the jar to the jars list.
  5. Remove the BasicUploadSkin.jar (if present).

Sample Custom Publishing Implementation

The following is an example structure of a custom publishing implementation:

CustomPublishExampleSrc | | frame_icon.png
| publish_customupload_16.png | publish_customupload_24.png | publish_customupload_48.png | \---com \---screencastomatic \---custompublish

File Specifications

The sizes for the 96-dpi png icons are as follows:

  • frame_icon.png: 48x48
  • publish_customupload_16.png: 16x16
  • publish_customupload_24.png: 24x24
  • publish_customupload_48.png: 48x48

We will provide example files to you.

Custom Publishing Sample (HTML)

We will provide example files to you.

The following properties can be set in the file:


This property contains the title displayed on the window for the application.



This property contains the title displayed at the top of the window when viewing the preview after recording.

som.*.app.preview.title=Upload to Mybrand


This property enables and disables the Show Draw and Zoom tool on the recorder.



This property enables and disables the Show Edit button to offer editing after recording.



This property contains the message displayed after upload is complete. (Note the TITLE_REPLACE which we will replace using the setDoneMessage in the CustomPublishImpl as an example that you can update this message dynamically or replace the complete message. ) 

<div style="font-size:17pt; text-align:left;">\
Uploaded Video:<br>\
You can set up a custom message here and also:\
<li>Choose if you want to show the link below.<br><br></li>\
<li>Choose if you want to launch a url when the <b>Continue</b> button below is pressed so you can direct the user to a playback page or any other url.</li>\
<br>For example, this app is set to go to when you click <b>Continue</b>\


When this property is set to true, the app deletes the local recording after a successful upload. When this property is set to false, the app does not remove the local recording.


This property enables and disables the Show a link and copy button for the URL returned after upload is complete.



This property provides an optional link to launch after the user clicks the button when upload is complete. Omit this setting if no page needs to launch. Otherwise, set this property to a URL or to the string "gotoplayback," which launches the URL you returned after the upload is complete.



This property sets the subdirectory to store your users’ recordings. The default location where this subdirectory is created is Documents. The following example creates Documents\Screen Recorder, and adds a Recordings directory with a subdirectory for each recording stored on the computer (Documents\Screen Recorder\Recordings\individual recording folders).

som.*.app.content.subdirectory=Screen Recorder


This property sets the name shown in the app. For example, "Upload to Mybrand."

som.*"Upload to Mybrand"


This property specifies the class that you provide to implement the com.screencastomatic.CustomPublish interface.


    • Related Articles

    • Configure the Basic Uploader

      Configuring the Basic Uploader Use the following information as a guide to configure how the basic uploader uploads a finished video file. Also see Setting Basic Uploader Properties for other properties you can set to customize the user interface. ...
    • Basic Uploader Properties

      Basic Uploader Properties Use the following properties to specify the upload of the recorded screen capture. Note that some properties are required and others are optional. Specify any of these by adding them to the launch properties. Table of ...
    • Use a custom domain (CNAME)

      Using a custom domain When you have a Solo Premier, Solo Max, Team Plan, a Legacy Business or Education Team plan, or you are using our Recorder API, you can use our site to host your content and configure it as a subdomain (for example, ...
    • Configure your Cloudflare proxy for an SSL certificate

      If you are using Cloudflare and you want to use a custom domain (CNAME) with an SSL certificate to host your content, you need to disable the proxy in your Cloudflare settings. Doing this enables us to successfully issue you an SSL certificate for ...
    • Configure how your video can be viewed and discovered

      You can configure specific settings in your hosting account to control how viewers discover and view your videos and images, including adding security protections. 1. Login to your account and visit MyContent. 2. Visit Details for you video or image. ...