Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.

PowerShell module for Asaph

Dramatic.Asaph provides a PowerShell way to publish images to micro blogging system Asaph.

Copyright (C) 2015 Victor Vogelpoel - Dramatic Development


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

IMPORTANT: This module is still under development.


  • Implement Publish-AsaphSite


Asaph is a PHP/MySQL based collection micro blogging system by PhobosLab. It is a small CMS that can pick images and text from web pages. You can find more information at

Asaph has no API, so this PowerShell module requests, scrapes and posts the Asaph pages.

Why Module "Dramatic.Asaph"?

I collect great images from photo sites and use various devices and apps to visit these sites. The Asaph picker can only be used on a PC; sometimes mailing myself the url of the photo page is the only thing I can resort to on other devices. An automated workflow enables me to read the photo page urls from my mail box and use the module's Publish-AsaphImage to register the photo into my Asaph sites.


It's short for Dramatic Development, my coding brand.


Open a PowerShell command box and run the following command to install this module straight from the GitHub repository to the WindowsPowerShell\Modules folder in the MyDocuments of your Windows user profile:

iex (New-Object Net.WebClient).DownloadString('')


  • Logging in to an Asaph site with specified credentials: Connect-Asaph.
  • Logging in to multiple Asaph sites; the module registers and caches the logon tokens in memory.
  • Publishing an image (eg giving Asaph an image url to download); Asaph will download the image from the image url and register it: Publish-AsaphImage.
  • Publish-AsaphImage returns the (enum) result of the publish action: SuccessImageIsPosted, SuccessImageWasAlreadyPosted, FailCouldntLoadTheImage, FailCouldntCreateThumbnailOfImage or FailUnknownError
  • Handles both http and https image urls.
  • Limitation: image url must be accessible without the need of logging on the source site.


# Advise: create a separate user account in Asaph web administration first, 
# which is to be used by this script below (for example: user "PowerShellbot").
# Enter these credentials when Get-Credentials below asks for it. 

# load the module
Import-Module 'Dramatic.Asaph'

# This is the Asaph site (do not specify "/admin"!) 
$asaphUrl = ''

# Ask credentials for Asaph; enter the credential for the separate user account.
$credentials = Get-Credentials

# Login to the Asaph site with the credentials
Connect-Asaph -AsaphUrl $asaphUrl -Credential $credentials

# Publish the specified image url to Asaph...
# Asaph will download the image and register it.
Publish-AsaphImage -ImageUrl '' -ImageTitle 'Test' -ImageSiteUrl '' -AsaphUrl $AsaphUrl

The Publish-Image cmdlet returns a custom object designating the publish result; in the following example two images were posted while the second had already been posted:

ImageTitle   ImageUrl                          ImageSiteUrl                 PublishResult                                                      
----------   --------                          ------------                 -------------                                                      
Beauty                              SuccessImageIsPosted                                       
Test SuccessImageWasAlreadyPosted



The Dramatic.Asaph module provides a PowerShell way to publish images to micro blogging system PhobosLab's Asaph





No releases published


No packages published