Compare revisions

*.pro.user

build_*/

lib/qtil/

stages:

  - build

ubuntu_deb:

  stage: build

  image: ubuntu:14.04

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package ubuntu_deb

  artifacts:

    paths:

    - build_*/ocs-url*.deb

    expire_in: 2 days

fedora_rpm:

  stage: build

  image: fedora:20

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package fedora_rpm

  artifacts:

    paths:

    - build_*/RPMS/x86_64/ocs-url*.rpm

    expire_in: 2 days

opensuse_rpm:

  stage: build

  image: opensuse:42.3

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package opensuse_rpm

  artifacts:

    paths:

    - build_*/RPMS/x86_64/ocs-url*.rpm

    expire_in: 2 days

archlinux_pkg:

  stage: build

  image: archlinux/base:latest

  only:

    - master

    - /^release\-.+/

  script:

    - ./scripts/package archlinux_pkg

  artifacts:

    paths:

    - build_*/ocs-url*.pkg.tar.xz

    expire_in: 2 days

# xdgurl

# ocs-url

An install helper program for desktop stuff.

[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

----

An install helper program for items served via OpenCollaborationServices (ocs://).

## How to install

Copyright: 2016-2019, Opendesktop.org

For Ubuntu/Debian system,

you can use "install.sh" in the project to install the program.

License: GPL-3+

    $ sh install.sh

Download Linux package from:

And you can use "uninstall.sh" to uninstall the program.

https://www.opendesktop.org/p/1136805/

    $ sh uninstall.sh

----

## How to use

#### From web browser

Open XDG-URL by click a links, or type XDG-URL in browser's address bar.

In firefox,

you can get a program selection window when first time to open XDG-URL,

and you can choose "xdgurl" as custom URL handler.

If you can not get program selection window,

you need set the xdgurl program as custom URL handler for xdg:// scheme in browser's settings.

#### From command-line terminal

Execute xdgurl program with XDG-URL as argument.

    $ xdgurl "XDG-URL"

----

## XDG-URL

XDG-URL is a custom URL that represent the install method for desktop stuff.

    [scheme]://[command]?[query string]

    For example:

    xdg://install?url=http%3A%2F%2Fexample.com%2Ficons.tar.gz&type=icons

#### Scheme

* xdg

* xdgs

For now, "xdgs" scheme is the same of the xdg scheme,

it's reserved name for secure method in the future.

#### Command

* download

* install

Command "download" will download the file from specified URL to local destination of specified install-type.

Command "install" will make file download and trigger install process.

#### Query string

XDG-URL's query string is an option of command.

*All query string values should be urlencoded.*

**url** = File URL of desktop stuff

Must be set.

**type** = Install-type

Optional.

Default is "downloads".

Available install-type:

Install-type | Local destination

-------------|------------------

downloads | ~/Downloads

documents | ~/Documents

pictures | ~/Pictures

music | ~/Music

videos | ~/Videos

wallpapers | ~/.local/share/wallpapers

fonts | ~/.fonts

cursors | ~/.icons

icons | ~/.local/share/icons

emoticons | ~/.local/share/emoticons

themes | ~/.themes

emerald_themes | ~/.emerald/themes

enlightenment_themes | ~/.e/e/themes

enlightenment_backgrounds | ~/.e/e/backgrounds

fluxbox_styles | ~/.fluxbox/styles

pekwm_themes | ~/.pekwm/themes

icewm_themes | ~/.icewm/themes

plasma_plasmoids | ~/.local/share/plasma/plasmoids

plasma_look_and_feel | ~/.local/share/plasma/look-and-feel

plasma_desktopthemes | ~/.local/share/plasma/desktoptheme

kwin_effects | ~/.local/share/kwin/effects

kwin_scripts | ~/.local/share/kwin/scripts

kwin_tabbox | ~/.local/share/kwin/tabbox

aurorae_themes | ~/.local/share/aurorae/themes

dekorator_themes | ~/.local/share/deKorator/themes

qtcurve | ~/.local/share/QtCurve

color_schemes | ~/.local/share/color-schemes

gnome_shell_extensions | ~/.local/share/gnome-shell/extensions

cinnamon_desklets | ~/.local/share/cinnamon/desklets

nautilus_scripts | ~/.local/share/nautilus/scripts

amarok_scripts | ~/.kde/share/apps/amarok/scripts

yakuake_skins | ~/.kde/share/apps/yakuake/skins

cairo_clock_themes | ~/.cairo-clock/themes

Available alias name of the install-type:

Alias | Install-type

------|-------------

gnome_shell_themes | themes

cinnamon_themes | themes

gtk2_themes | themes

gtk3_themes | themes

metacity_themes | themes

xfwm4_themes | themes

openbox_themes | themes

kvantum_themes | themes

compiz_themes | emerald_themes

beryl_themes | emerald_themes

plasma4_plasmoids | plasma_plasmoids

plasma5_plasmoids | plasma_plasmoids

plasma5_look_and_feel | plasma_look_and_feel

plasma5_desktopthemes | plasma_desktopthemes

plasma_color_schemes | color_schemes

**filename** = Alternative file name

Optional.

This option is useful if the download URL does not represent the file name.

And please see docs/* for more information.

CONFIG += c++11

QT += \

    core \

    gui \

    widgets \

    qml \

    quick \

    svg

HEADERS += \

    $${PWD}/src/handlers/confighandler.h \

    $${PWD}/src/handlers/ocsurlhandler.h

SOURCES += \

    $${PWD}/src/main.cpp \

    $${PWD}/src/handlers/confighandler.cpp \

    $${PWD}/src/handlers/ocsurlhandler.cpp

RESOURCES += \

    $${PWD}/configs/configs.qrc \

    $${PWD}/images/images.qrc \

    $${PWD}/qml/qml.qrc

INCLUDEPATH += $${PWD}/src

{

    "id": "ocs-url",

    "name": "ocs-url",

    "version": "3.1.0",

    "organization": "Opendesktop.org",

    "domain": "org.opendesktop.ocs-url",

    "icon": ":/desktop/ocs-url.svg",

    "description": "An install helper program for items served via OpenCollaborationServices (ocs://).",

    "license": "GPL-3+",

    "author": "Opendesktop.org",

    "contact": "contact@opendesktop.org",

    "homepage": "https://git.opendesktop.org/akiraohgaki/ocs-url"

}

<RCC>

    <qresource prefix="/configs">

        <file>application.json</file>

        <file>install_types.json</file>

        <file>install_types_alias.json</file>

    </qresource>

</RCC>

{

    "bin": {

        "name": "Software",

        "destination": "$HOME/.local/bin",

        "generic_destination": "$APP_DATA/bin"

    },

    "downloads": {

        "name": "Downloads",

        "destination": "$XDG_DOWNLOAD_DIR",

        "generic_destination": "$APP_DATA/downloads"

    },

    "documents": {

        "name": "Documents",

        "destination": "$XDG_DOCUMENTS_DIR",

        "generic_destination": "$APP_DATA/documents"

    },

    "pictures": {

        "name": "Pictures",

        "destination": "$XDG_PICTURES_DIR",

        "generic_destination": "$APP_DATA/pictures"

    },

    "music": {

        "name": "Music",

        "destination": "$XDG_MUSIC_DIR",

        "generic_destination": "$APP_DATA/music"

    },

    "videos": {

        "name": "Videos",

        "destination": "$XDG_VIDEOS_DIR",

        "generic_destination": "$APP_DATA/videos"

    },

    "wallpapers": {

        "name": "Wallpapers",

        "destination": "$XDG_DATA_HOME/wallpapers",

        "generic_destination": "$APP_DATA/wallpapers"

    },

    "fonts": {

        "name": "Fonts",

        "destination": "$HOME/.fonts",

        "generic_destination": "$APP_DATA/fonts"

    },

    "cursors": {

        "name": "Cursors",

        "destination": "$HOME/.icons",

        "generic_destination": "$APP_DATA/cursors"

    },

    "icons": {

        "name": "Icons",

        "destination": "$XDG_DATA_HOME/icons",

        "generic_destination": "$APP_DATA/icons"

    },

    "emoticons": {

        "name": "Emoticons",

        "destination": "$XDG_DATA_HOME/emoticons",

        "generic_destination": "$APP_DATA/emoticons"

    },

    "themes": {

        "name": "Desktop Themes",

        "destination": "$HOME/.themes",

        "generic_destination": "$APP_DATA/themes"

    },

    "emerald_themes": {

        "name": "Emerald Themes",

        "destination": "$HOME/.emerald/themes",

        "generic_destination": "$APP_DATA/emerald_themes"

    },

    "enlightenment_themes": {

        "name": "Enlightenment Themes",

        "destination": "$HOME/.e/e/themes",

        "generic_destination": "$APP_DATA/enlightenment_themes"

    },

    "enlightenment_backgrounds": {

        "name": "Enlightenment Backgrounds",

        "destination": "$HOME/.e/e/backgrounds",

        "generic_destination": "$APP_DATA/enlightenment_backgrounds"

    },

    "fluxbox_styles": {

        "name": "Fluxbox Styles",

        "destination": "$HOME/.fluxbox/styles",

        "generic_destination": "$APP_DATA/fluxbox_styles"

    },

    "pekwm_themes": {

        "name": "PekWM Themes",

        "destination": "$HOME/.pekwm/themes",

        "generic_destination": "$APP_DATA/pekwm_themes"

    },

    "icewm_themes": {

        "name": "IceWM Themes",

        "destination": "$HOME/.icewm/themes",

        "generic_destination": "$APP_DATA/icewm_themes"

    },

    "plasma_plasmoids": {

        "name": "Plasma Plasmoids",

        "destination": "$XDG_DATA_HOME/plasma/plasmoids",

        "generic_destination": "$APP_DATA/plasma_plasmoids"

    },

    "plasma_look_and_feel": {

        "name": "Plasma Look and Feel",

        "destination": "$XDG_DATA_HOME/plasma/look-and-feel",

        "generic_destination": "$APP_DATA/plasma_look_and_feel"

    },

    "plasma_desktopthemes": {

        "name": "Plasma Desktop Themes",

        "destination": "$XDG_DATA_HOME/plasma/desktoptheme",

        "generic_destination": "$APP_DATA/plasma_desktopthemes"

    },

    "kwin_effects": {

        "name": "KWin Effects",

        "destination": "$XDG_DATA_HOME/kwin/effects",

        "generic_destination": "$APP_DATA/kwin_effects"

    },

    "kwin_scripts": {

        "name": "KWin Scripts",

        "destination": "$XDG_DATA_HOME/kwin/scripts",

        "generic_destination": "$APP_DATA/kwin_scripts"

    },

    "kwin_tabbox": {

        "name": "KWin Window Switcher",

        "destination": "$XDG_DATA_HOME/kwin/tabbox",

        "generic_destination": "$APP_DATA/kwin_tabbox"

    },

    "aurorae_themes": {

        "name": "Aurorae Themes",

        "destination": "$XDG_DATA_HOME/aurorae/themes",

        "generic_destination": "$APP_DATA/aurorae_themes"

    },

    "dekorator_themes": {

        "name": "deKorator Themes",

        "destination": "$XDG_DATA_HOME/deKorator/themes",

        "generic_destination": "$APP_DATA/dekorator_themes"

    },

    "qtcurve": {

        "name": "QtCurve Themes",

        "destination": "$XDG_DATA_HOME/QtCurve",

        "generic_destination": "$APP_DATA/qtcurve"

    },

    "color_schemes": {

        "name": "KDE Color Schemes",

        "destination": "$XDG_DATA_HOME/color-schemes",

        "generic_destination": "$APP_DATA/color_schemes"

    },

    "gnome_shell_extensions": {

        "name": "Gnome Shell Extensions",

        "destination": "$XDG_DATA_HOME/gnome-shell/extensions",

        "generic_destination": "$APP_DATA/gnome_shell_extensions"

    },

    "cinnamon_applets": {

        "name": "Cinnamon Applets",

        "destination": "$XDG_DATA_HOME/cinnamon/applets",

        "generic_destination": "$APP_DATA/cinnamon_applets"

    },

    "cinnamon_desklets": {

        "name": "Cinnamon Desklets",

        "destination": "$XDG_DATA_HOME/cinnamon/desklets",

        "generic_destination": "$APP_DATA/cinnamon_desklets"

    },

    "cinnamon_extensions": {

        "name": "Cinnamon Extensions",

        "destination": "$XDG_DATA_HOME/cinnamon/extensions",

        "generic_destination": "$APP_DATA/cinnamon_extensions"

    },

    "nautilus_scripts": {

        "name": "Nautilus Scripts",

        "destination": "$XDG_DATA_HOME/nautilus/scripts",

        "generic_destination": "$APP_DATA/nautilus_scripts"

    },

    "amarok_scripts": {

        "name": "Amarok Scripts",

        "destination": "$KDEHOME/share/apps/amarok/scripts",

        "generic_destination": "$APP_DATA/amarok_scripts"

    },

    "yakuake_skins": {

        "name": "Yakuake Skins",

        "destination": "$KDEHOME/share/apps/yakuake/skins",

        "generic_destination": "$APP_DATA/yakuake_skins"

    },

    "cairo_clock_themes": {

        "name": "Cairo-Clock Themes",

        "destination": "$HOME/.cairo-clock/themes",

        "generic_destination": "$APP_DATA/cairo_clock_themes"

    },

    "books": {

        "name": "Books",

        "destination": "$APP_DATA/books",

        "generic_destination": "$APP_DATA/books"

    },

    "comics": {

        "name": "Comics",

        "destination": "$APP_DATA/comics",

        "generic_destination": "$APP_DATA/comics"

    }

}

{

    "gnome_shell_themes": {

        "base": "themes",

        "name": "Gnome Shell Themes"

    },

    "cinnamon_themes": {

        "base": "themes",

        "name": "Cinnamon Themes"

    },

    "gtk2_themes": {

        "base": "themes",

        "name": "GTK2 Themes"

    },

    "gtk3_themes": {

        "base": "themes",

        "name": "GTK3 Themes"

    },

    "metacity_themes": {

        "base": "themes",

        "name": "Metacity Themes"

    },

    "xfwm4_themes": {

        "base": "themes",

        "name": "XFWM4 Themes"

    },

    "openbox_themes": {

        "base": "themes",

        "name": "Openbox Themes"

    },

    "kvantum_themes": {

        "base": "themes",

        "name": "Kvantum Themes"

    },

    "compiz_themes": {

        "base": "emerald_themes",

        "name": "Compiz Themes"

    },

    "beryl_themes": {

        "base": "emerald_themes",

        "name": "Beryl Themes"

    },

    "plasma4_plasmoids": {

        "base": "plasma_plasmoids",

        "name": "Plasma4 Plasmoids"

    },

    "plasma5_plasmoids": {

        "base": "plasma_plasmoids",

        "name": "Plasma5 Plasmoids"

    },

    "plasma5_look_and_feel": {

        "base": "plasma_look_and_feel",

        "name": "Plasma5 Look and Feel"

    },

    "plasma5_desktopthemes": {

        "base": "plasma_desktopthemes",

        "name": "Plasma5 Desktop Themes"

    },

    "plasma_color_schemes": {

        "base": "color_schemes",

        "name": "Plasma Color Schemes"

    }

}

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">

<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0" y="0" width="128" height="128" viewBox="0, 0, 128, 128">

  <g id="icon">

    <path d="M64,8 C33.072,8 8,33.072 8,64 C8,94.928 33.072,120 64,120 C94.928,120 120,94.928 120,64 C120,33.072 94.928,8 64,8 z M64,24 C68.418,24 72,27.582 72,32 C72,36.418 68.418,40 64,40 C59.582,40 56,36.418 56,32 C56,27.582 59.582,24 64,24 z M48,48 L72,48 L72,96 L80,96 L80,104 L48,104 L48,96 L56,96 L56,56 L48,56 L48,48 z" fill="#000000" id="dialog-information"/>

  </g>

</svg>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">

<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0" y="0" width="128" height="128" viewBox="0, 0, 128, 128">

  <g id="icon">

    <path d="M64,16 L8,112 L120,112 L64,16 z M56,48 L72,48 L72,80 L56,80 L56,48 z M64,88 C68.418,88 72,91.582 72,96 C72,100.418 68.418,104 64,104 C59.582,104 56,100.418 56,96 C56,91.582 59.582,88 64,88 z" fill="#000000" id="dialog-warning"/>

  </g>

</svg>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">

<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0" y="0" width="128" height="128" viewBox="0, 0, 128, 128">

  <g id="icon">

    <path d="M64,8 C33.072,8 8,33.072 8,64 C8,94.928 33.072,120 64,120 C94.928,120 120,94.928 120,64 C120,33.072 94.928,8 64,8 z M80,32 L104,32 L56,104 L32,80 L32,56 L56,80 L80,32 z" fill="#000000" id="emblem-default"/>

  </g>

</svg>

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">

<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0" y="0" width="128" height="128" viewBox="0, 0, 128, 128">

  <g id="icon">

    <path d="M40,8 L40,48 L16,48 L64,96 L112,48 L88,48 L88,8 L40,8 z M8,72 L8,120 L120,120 L120,72 L104,72 L104,104 L24,104 L24,72 L8,72 z" fill="#000000" id="emblem-downloads"/>

  </g>

</svg>

<RCC>

    <qresource prefix="/images">

        <file>icons/dialog-information.svg</file>

        <file>icons/dialog-warning.svg</file>

        <file>icons/emblem-default.svg</file>

        <file>icons/emblem-downloads.svg</file>

    </qresource>

</RCC>

import QtQuick 2.0

import QtQuick.Layouts 1.0

import QtQuick.Controls 1.0

import "u