Difference between revisions of "Create a Core Wallet desktop entry on Ubuntu Desktop"

From DigiByte Wiki
Jump to navigation Jump to search
m (test edit to see what the "Summary" field is..)
(9 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
A desktop entry file is used as a shortcut file. It retains information of a certain script or application on your Ubuntu machine, such as file location, icon, version, type, description etc.[https://specifications.freedesktop.org/desktop-entry-spec/latest/]
 
A desktop entry file is used as a shortcut file. It retains information of a certain script or application on your Ubuntu machine, such as file location, icon, version, type, description etc.[https://specifications.freedesktop.org/desktop-entry-spec/latest/]
 
===Why would you want a entry file?===
 
===Why would you want a entry file?===
You don’t need to start your wallet from the terminal. With a entry file set up you can simply start the DigiByte Core Wallet directly from the Ubuntu application browser.<br />
+
You don’t need to start your wallet from the terminal. With a entry file set up you can simply start the DigiByte Core Wallet directly from the Ubuntu application browser.<br>
 
Using something like Gnome Tweaks you can easily search and pick your desktop entry for autostart when you log in to your machine.
 
Using something like Gnome Tweaks you can easily search and pick your desktop entry for autostart when you log in to your machine.
  
 
== Create desktop entry ==
 
== Create desktop entry ==
 
=== Download icon ===
 
=== Download icon ===
You don’t need to use a icon, but it makes for better looks and makes the wallet easier to find while browsing your applications.<br>
+
You don’t need to use a icon, but it makes for better looks and makes the wallet easier to find when browsing your applications.<br>
 
Use the application browser or press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>T</kbd> to open a terminal.<br>
 
Use the application browser or press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>T</kbd> to open a terminal.<br>
Navigate to your DigiByte Core wallet Location and create a new folder named
+
Navigate to your DigiByte Core wallet location and create a new folder called
 
<code>desktop</code>. Navigate to your new folder and download the icon with the <code>wget</code> command.
 
<code>desktop</code>. Navigate to your new folder and download the icon with the <code>wget</code> command.
 
<b>Example:</b><pre style="margin-top:0;">
 
<b>Example:</b><pre style="margin-top:0;">
Line 29: Line 29:
 
Paste the following:
 
Paste the following:
 
<pre>[Desktop Entry]
 
<pre>[Desktop Entry]
Version=1.0
 
 
Name=DigiByte Core Wallet
 
Name=DigiByte Core Wallet
 
Comment=Official DigiByte Core Wallet for Linux
 
Comment=Official DigiByte Core Wallet for Linux
Line 36: Line 35:
 
Categories=Crypto;Network;Qt;
 
Categories=Crypto;Network;Qt;
 
Keywords=dgb;core;digibyte;wallet;node;desktop;
 
Keywords=dgb;core;digibyte;wallet;node;desktop;
X-GNOME-UsesNotifications=true
 
 
Exec=
 
Exec=
 
Icon=</pre>
 
Icon=</pre>
Line 47: Line 45:
 
<br>
 
<br>
 
<i>Now save the file, and you're done!</i><br>
 
<i>Now save the file, and you're done!</i><br>
To save the file in nano, press <kbd>Ctrl</kbd>+<kbd>X</kbd> followed by <kbd>Y</kbd>, then press <kbd>Enter</kbd>.<br>
+
To save the file in nano, press <kbd>Ctrl</kbd>+<kbd>X</kbd> followed by <kbd>Y</kbd> to confirm, then press <kbd>Enter</kbd>.<br>
<u>If you have performed all of these steps correctly, you should now be able to launch the DigiByte Core Wallet from the application browser on your Ubuntu Desktop 18.04+.</u>
+
<u>If you have performed all of these steps correctly, you should now be able to launch the DigiByte Core Wallet from the application browser on your Ubuntu Desktop.</u>
  
 
== Extra notes ==
 
== Extra notes ==
The <code>Version</code> attribute of a Desktop Entry represents the version of the <code>.desktop</code> file, not the DigiByte Core Wallet.<br><br>
+
* <code>.desktop</code> files can also be placed in <code>/usr/share/applications/</code> but it is not recommended as any user on your machine could technically get access to your wallet.
<code>.desktop</code> files can also be placed in /usr/share/applications/ but it is not recommended as any user on your machine could technically get access to your wallet.<br><br>
+
* This solution should work on most KDE & GNOME distro's according to freedesktop [https://specifications.freedesktop.org/desktop-entry-spec/latest/ documentation].
This should work on most KDE & Gnome distro's according to freedesktop [https://specifications.freedesktop.org/desktop-entry-spec/latest/ documentation].
 

Revision as of 15:37, 4 May 2020

Introduction

What is a desktop entry file?

A desktop entry file is used as a shortcut file. It retains information of a certain script or application on your Ubuntu machine, such as file location, icon, version, type, description etc.[1]

Why would you want a entry file?

You don’t need to start your wallet from the terminal. With a entry file set up you can simply start the DigiByte Core Wallet directly from the Ubuntu application browser.
Using something like Gnome Tweaks you can easily search and pick your desktop entry for autostart when you log in to your machine.

Create desktop entry

Download icon

You don’t need to use a icon, but it makes for better looks and makes the wallet easier to find when browsing your applications.
Use the application browser or press Ctrl+Alt+T to open a terminal.
Navigate to your DigiByte Core wallet location and create a new folder called desktop. Navigate to your new folder and download the icon with the wget command.

Example:

cd ~/digibyte-7.17.2/
mkdir desktop
cd desktop
wget https://github.com/DigiByte-Core/digibyte-logos/raw/master/Symbol%20Icons/512x512.png

Writing the file

It's important to perform these terminal commands as the user that is going to be using the wallet on the machine, no other users will have access to your desktop entry.
Create a new file called digibyte-qt.desktop in ~/.local/share/applications/ using the touch command.

touch ~/.local/share/applications/digibyte-qt.desktop

The ~ represents your home folder(/home/USERNAME/).

Edit the file using a text editor.
For this example we will use the nano command from terminal.

nano ~/.local/share/applications/digibyte-qt.desktop

Paste the following:

[Desktop Entry]
Name=DigiByte Core Wallet
Comment=Official DigiByte Core Wallet for Linux
Terminal=false
Type=Application
Categories=Crypto;Network;Qt;
Keywords=dgb;core;digibyte;wallet;node;desktop;
Exec=
Icon=

Write the full path to digibyte-qt after Exec=.

Example:

Exec=/home/USERNAME/digibyte-7.17.2/bin/digibyte-qt


Now add the full path to your icon after Icon=.

Example:

Icon=/home/USERNAME/digibyte-7.17.2/desktop/512x512.png

USERNAME should be replaced with your own username.
Now save the file, and you're done!
To save the file in nano, press Ctrl+X followed by Y to confirm, then press Enter.
If you have performed all of these steps correctly, you should now be able to launch the DigiByte Core Wallet from the application browser on your Ubuntu Desktop.

Extra notes

  • .desktop files can also be placed in /usr/share/applications/ but it is not recommended as any user on your machine could technically get access to your wallet.
  • This solution should work on most KDE & GNOME distro's according to freedesktop documentation.