-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
initial release and first build - Wed 06 Oct 2021 10:42:55 PM CDT
- Loading branch information
1 parent
3ffc9a8
commit 2edbed7
Showing
36 changed files
with
1,422 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| *.c linguist-detectable=false | ||
| makefile linguist-detectable=false | ||
| *.o linguist-detectable=false | ||
| *.ao linguist-detectable=false | ||
| *.obj linguist-detectable=false | ||
| *.res linguist-detectable=false | ||
| *.idb linguist-detectable=false | ||
| *.pdb linguist-detectable=false | ||
| *.log linguist-detectable=false | ||
| *.tlog linguist-detectable=false | ||
| *.recipe linguist-detectable=false | ||
| *.aps linguist-detectable=false | ||
| *.h linguist-detectable=false | ||
| *.sh linguist-detectable=false | ||
| *.yml linguist-detectable=false | ||
| *.yaml linguist-detectable=false | ||
| *.sln linguist-detectable=false |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,59 @@ | ||
| name: Build | ||
|
|
||
| on: | ||
| push: | ||
| branches: [ master ] | ||
| pull_request: | ||
| branches: [ master ] | ||
| # on: | ||
| # push: | ||
| # paths: | ||
| # - '**.cpp' | ||
| # - '**.h' | ||
| # - '**.o' | ||
| # - '**.sln' | ||
| # - 'makefile' | ||
|
|
||
| jobs: | ||
| build_linux: | ||
| name: Build Project | ||
| runs-on: ubuntu-latest | ||
| steps: | ||
| - uses: actions/checkout@v2 | ||
| - name: Make | ||
| run: | | ||
| if [[ -d "release" ]]; then | ||
| rm -rf release | ||
| fi | ||
| ./scripts/build.sh | ||
| desktopgen_linux_md5_text='{\n\t"schemaVersion": 1,\n\t"color": "2E9778",\n\t"label": "desktopgen MD5",\n\t"message": "PLACEHOLDER",\n\t"labelColor": "1d1d1d",\n\t"style": "for-the-badge",\n\t"namedLogo": "linux"\n}' | ||
| if ! [[ -d "./docs/json" ]]; then | ||
| mkdir -p ./docs/json | ||
| fi | ||
| if ! [[ -f "./docs/json/desktopgen_linux_md5.json" ]]; then | ||
| touch ./docs/json/desktopgen_linux_md5.json | ||
| fi | ||
| echo -e "$desktopgen_linux_md5_text" > ./docs/json/desktopgen_linux_md5.json | ||
| sed -i "s/\"message\": \".*\"/\"message\": \"$(md5sum ./release/linux/dynamic/desktopgen | cut -d' ' -f 1)\"/g" docs/json/desktopgen_linux_md5.json | ||
| desktopgen_debian_md5_text='{\n\t"schemaVersion": 1,\n\t"color": "2E9778",\n\t"label": "desktopgen.deb MD5",\n\t"message": "PLACEHOLDER",\n\t"labelColor": "1d1d1d",\n\t"style": "for-the-badge",\n\t"namedLogo": "debian"\n}' | ||
| if ! [[ -d "docs/json" ]]; then | ||
| mkdir -p docs/json | ||
| fi | ||
| if ! [[ -f "docs/json/desktopgen_debian_md5.json" ]]; then | ||
| touch docs/json/desktopgen_debian_md5.json | ||
| fi | ||
| echo -e "$desktopgen_debian_md5_text" > ./docs/json/desktopgen_debian_md5.json | ||
| sed -i "s/\"message\": \".*\"/\"message\": \"$(md5sum release/debian/desktopgen.deb | cut -d' ' -f 1)\"/g" docs/json/desktopgen_debian_md5.json | ||
| git add . | ||
| git config --global user.name 'Lateralus138' | ||
| git config --global user.email 'Lateralus138@users.noreply.github.com' | ||
| git commit -am "Pushed new project files to master. - $(date)" | ||
| git push | ||
| - uses: ncipollo/release-action@v1 | ||
| with: | ||
| allowUpdates: True | ||
| tag: 1.0.0 | ||
| name: Stable Release | ||
| prerelease: False | ||
| artifacts: "./release/debian/desktopgen.deb,./release/linux/dynamic/desktopgen" | ||
| token: ${{ secrets.GITHUB_TOKEN }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| *.*workspace |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,2 +1,191 @@ | ||
| # desktopgen | ||
| # DesktopGen | ||
|
|
||
| Generate Linux .desktop shortcut files from the command line. | ||
|
|
||
| <img src="docs/media/images/desktopgen.png" width="96"> | ||
|
|
||
| - [DesktopGen](#desktopgen) | ||
| - [Description](#description) | ||
| - [Installation](#installation) | ||
| - [Portable](#portable) | ||
| - [Debian Package Installer](#debian-package-installer) | ||
| - [Usage](#usage) | ||
| - [Examples](#examples) | ||
| - [Create program shortcut](#create-program-shortcut) | ||
| - [Help Screen](#help-screen) | ||
| - [Bash Completion](#bash-completion) | ||
| - [Project Information](#project-information) | ||
| - [File Information](#file-information) | ||
| - [MD5](#md5) | ||
| - [Media](#media) | ||
|
|
||
| --- | ||
|
|
||
| ## Description | ||
|
|
||
| This is a tool written in *C++* that helps me quickly create *Linux* `.desktop` shortcut files from the command line. | ||
|
|
||
| If you are not familiar with these files they are Linux application/command line **shortcut** files just like you find in Windows or many other operating systems. | ||
|
|
||
| This generates a basic template with a few defaults and parameter/arguments for the most common *Entries* that many find in a *.desktop file* and is not meant to have an extensive list of paramters for every *Entry* under the sun. Having said that you can circumvent this and add any additional *Entries* you want by simply appending some formatted text of the *Entries* you want with one of the pre-existing parameters. | ||
| For example: | ||
|
|
||
| ```Bash | ||
| $ desktopgen --file fakeshortcut --icon "$(echo -e \\nFakeKey=FakeValue)" | ||
| $ cat fakeshortcut.desktop | ||
| [Desktop Entry] | ||
| Name= | ||
| GenericName= | ||
| Comment= | ||
| Exec= | ||
| Terminal=false | ||
| Type=Application | ||
| Icon= | ||
| FakeKey=FakeValue | ||
| Categories=GNOME;GTK;Utility; | ||
| ``` | ||
|
|
||
| will add the new Key/Value pair in after the Icon *Entry* with the `\\n` new line. You can still set the Icon (or whatever parameter) by adding the text before the new line. In this way you preformat your added values in a variable/array and append anything you want. You can override any default by it's corresponding parameter. | ||
|
|
||
| More information about *.desktop* files and *Entries*,*Categories* etc... can be found here: [[FreeDesktop Specifications](https://specifications.freedesktop.org/desktop-entry-spec/latest/)] | ||
|
|
||
| I do most things from the command line if possible, but I'm working on a little *YAD*/*Zenity* UI, but I might make a GTK gui for it in the near future. I have lots of other projects and to work on, but this project was spawned from inspiration and necessity and so other things had to wait while I wrote this first, but I'm not sure when I'll get around to a real UI. There are other methods to create shortcuts, but this is my method. | ||
|
|
||
| --- | ||
|
|
||
| ## Installation | ||
|
|
||
| This is a single binary executable built on and for 64 bit Linux machines and here I have provided several methods of use and installation. All files are found in the [Releases](https://github.com/Lateralus138/desktopgen/releases) section. | ||
|
|
||
| ### Portable | ||
|
|
||
| A single compiled binary executable is provided unless you want to download the source and build it yourself. This file's name is ***`desktopgen`***. | ||
|
|
||
|
|
||
| ### Debian Package Installer | ||
|
|
||
| I have provided a *.deb* package installer that contains teh program, bash completion, and icons that will be removed upon un-installing. Sorry, I do not have a PPA yet, though I have started the process. This file's name is ***`desktopgen.deb`***. | ||
|
|
||
| --- | ||
|
|
||
| ## Usage | ||
|
|
||
| As stated above this is a command line utility for *Linux* shells/terminals/consoles/whatever/etc... And also, as stated above, this could work well with a YAD/Zenity GUI. | ||
|
|
||
| ### Examples | ||
|
|
||
| #### Create program shortcut | ||
|
|
||
| ```Bash | ||
| $ desktopgen \ | ||
| > --path ~/.local/share/applications \ | ||
| > --file ProgramName \ | ||
| > --name "Program Name" \ | ||
| > --generic "ProgramName" \ | ||
| > --comment "Program Name does something" \ | ||
| > --exec "/path/to/programname" \ | ||
| > --icon "/path/or/name/of/icon" | ||
| $ cat ~/.local/share/applications/Programname.desktop | ||
| [Desktop Entry] | ||
| Name=Program Name | ||
| GenericName=ProgramName | ||
| Comment=Program Name does something | ||
| Exec=/path/to/programname | ||
| Terminal=false | ||
| Type=Application | ||
| Icon=/path/or/name/of/icon | ||
| Categories=GNOME;GTK;Utility; | ||
| ``` | ||
|
|
||
| #### Help Screen | ||
|
|
||
| ```Bash | ||
| $ desktopgen --help | ||
|
|
||
| 'desktopgen' - Generate .desktop shortcut files | ||
| from the command line. | ||
|
|
||
| USAGE: desktopgen [OPTIONS]... | ||
|
|
||
| OPTIONS: | ||
| -h,--help This help screen. | ||
| -p,--path Directory of the new file. | ||
| -f,--file The name of the file without | ||
| the .desktop extension. This | ||
| parameter has to be provided. | ||
| -m,--monochrome Remove color from all output. | ||
| -q,--quiet All errors are non-verbose. | ||
| -n,--name [Name] string entry. | ||
| -g,--generic [GenericName] string entry. | ||
| -c,--comment [Comment] string entry. | ||
| -e,--exec [Exec] string entry. | ||
| -T,--terminal [Terminal] string entry. | ||
| -t,--type [Type] string entry. | ||
| -i,--icon [Icon] string entry. | ||
| -C,--categories [Categories] string entry. | ||
|
|
||
| ``` | ||
|
|
||
| ### Bash Completion | ||
|
|
||
| Bash completion can be provided either by installing with the *.deb* installer or found [here](./debian/usr/share/bash-completion/completions/desktopgen). | ||
|
|
||
| --- | ||
|
|
||
| ## Project Information | ||
|
|
||
| This project is written in `C++`. | ||
|
|
||
| [](http://www.cplusplus.org/) | ||
|
|
||
|  | ||
|
|
||
| |Description|Status| | ||
| |:---:|:---:| | ||
| |CodeFactor Grade|| | ||
| |Project Release Date|| | ||
| |Total downloads for this project|| | ||
| |Complete repository size|| | ||
| |Commits in last month|| | ||
| |Commits in last year|| | ||
|
|
||
| Latest Version Status | ||
|
|
||
| |Description|Status|Number of Downloads| | ||
| |:---:|:---:|:---:| | ||
| |Latest Release version||| | ||
| |Latest Tag version, possible Pre-Release's||| | ||
|
|
||
| ### File Information | ||
|
|
||
| All current compiled files and the source of this project can be found at this repository in the **`Releases`** section under **`Stable Release`**. | ||
|
|
||
| ***This is the recommended method of download.*** | ||
|
|
||
| [](https://github.com/Lateralus138/desktopgen/releases/tag/1.0.0) | ||
|
|
||
| You can, of course, build, fork, and/or download the source of this project as per the [LICENSE](./LICENSE) of this project. If you want me to create a build for a different architecture and don't want to do it yourself then just let me know what you need and I'll look into it. | ||
|
|
||
| ### MD5 | ||
|
|
||
| These MD5 values are evaluated immediately after the build. | ||
|
|
||
| Linux MD5 | ||
|
|
||
|  | ||
|
|
||
| Debian MD5 | ||
|
|
||
|  | ||
|
|
||
| --- | ||
|
|
||
| ## Media | ||
|
|
||
| Logo | ||
|
|
||
|  | ||
|
|
||
| Help Screen | ||
|
|
||
|  |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,9 @@ | ||
| Package: desktopgen | ||
| Version: 1.0.0 | ||
| Section: Utilities | ||
| Priority: optional | ||
| Architecture: amd64 | ||
| Essential: no | ||
| Installed-Size: 212 | ||
| Maintainer: https://github.com/Lateralus138/desktopgen | ||
| Description: Generate .desktop shortcut files from the command line. |
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| desktopgen_list=( | ||
| -h --help | ||
| -p --path | ||
| -f --file | ||
| -m --monochrome | ||
| -q --quiet | ||
| -n --name | ||
| -g --generic | ||
| -c --comment | ||
| -e -exec | ||
| -T --terminal | ||
| -t --type | ||
| -i --icon | ||
| -C --categories | ||
| ) | ||
| complete -W "$(printf '%s\n' "${desktopgen_list[@]}")" desktopgen | ||
|
|
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| { | ||
| "schemaVersion": 1, | ||
| "color": "2E9778", | ||
| "label": "Programming Language", | ||
| "message": "C++", | ||
| "labelColor": "1d1d1d", | ||
| "style": "for-the-badge" | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| { | ||
| "schemaVersion": 1, | ||
| "color": "2E9778", | ||
| "label": "Current Releases", | ||
| "message": "Click Here", | ||
| "labelColor": "1d1d1d", | ||
| "style": "for-the-badge" | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,9 @@ | ||
| { | ||
| "schemaVersion": 1, | ||
| "color": "2E9778", | ||
| "label": "desktopgen.deb MD5", | ||
| "message": "2f793868c3232c3d570e59e8bf1d7708", | ||
| "labelColor": "1d1d1d", | ||
| "style": "for-the-badge", | ||
| "namedLogo": "debian" | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,9 @@ | ||
| { | ||
| "schemaVersion": 1, | ||
| "color": "2E9778", | ||
| "label": "desktopgen MD5", | ||
| "message": "af870a7c200a0cabe427263740e2f028", | ||
| "labelColor": "1d1d1d", | ||
| "style": "for-the-badge", | ||
| "namedLogo": "linux" | ||
| } |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.