Some common questions/answers.
No, you can run it standalone. For most releases I'll provide docker images along with zip/tar files for the server and Desktop apps, for MacOS, Windows and Linux.
Etymology of the name: DAM-sel-fly - Digital Asset Management that flies.
Damselfly is written using C#/.Net 7 and Blazor WebAssembly. The data model and DB access is using Entity Framework Core. Currently the server supports Sqlite, but a future enhancement may be to add support for PostGres, MySql or MariaDB.
Damselfly allows direct uploads of photographs to the media library of a Wordpress Blog. To enable this feature, you must configure your Wordpress site to support JWT authentication. For more details see JWT Authentication for WP REST API.
To enable this option you’ll need to edit your .htaccess file adding the following:
RewriteEngine on
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) - [E=HTTP_AUTHORIZATION:%1]
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
The JWT needs a secret key to sign the token this secret key must be unique and never revealed. To add the secret key edit your wp-config.php file and add a new constant called JWT_AUTH_SECRET_KEY
define('JWT_AUTH_SECRET_KEY', 'your-top-secret-key');
To enable the CORs Support edit your wp-config.php file and add a new constant called JWT_AUTH_CORS_ENABLE
define('JWT_AUTH_CORS_ENABLE', true);
You can use a string from here.
Once you have the site configured:
- Install the Wordpress JWT Authentication for WP REST API plugin.
- Use the config page in Damselfly to set the website URL, username and password. I recommend setting up a dedicated user account for Damselfly to use.