[VirusTotal]

Read this before: OMNICOIN VOCABULARY - Some Omnicoin words you might hear

INSTALLATION:

DOWNLOAD
Omnicoin-Qt is the default client for the Omnicoin network.

The latest download of Omnicoin-Qt can be found here.
There are executables for all platforms including Windows and Mac.
Go ahead and download your version, and install it. If you have and problems during this guide with Omnicoin-Qt you can ask for help on #omnicoin on IRC. If you don't have an IRC client use webchat here.

EXTRACT
Once downloaded, navigate to the downloaded file and extract the file contents. This can be done by right clicking the file and selecting "Extract Files"


Once extracted, navigateto the Omnicoin folder and open OmniCoin-qt.exe


You should be presented with a splash screen:


SYNC
It will take a few minutes when first running the software. You should be then presented with something like this:


WAIT
Omnicoin-Qt now has to do is catch up to the rest of the Omnicoin network. Its downloading and verifying the Blockchain, which is the public record of all the Omnicoins and transactions ever. It is going to take ~1 hour to fully sync on a normal connection, but thankfully you will only have to do this once.

Take this time to go outside and toss a frisbee. Or if outside is too scary, you can read more about Omnicoin from these places:

• https://hackforums.net/showthread.php?tid=4202528
  
• http://www.omnicoin.pw/
  
• https://hackforums.net/showthread.php?tid=4133835
  

FULLY SYNCED
Ah, your back! Omnicoin-Qt is fully synced when the green progress bar disappears, and there is a small checkmark in the bottom right hand corner. It should look something like this:

HOW TO USE OMNICOIN-QT:

CREATE AN ADDRESS
Your wallet will automatically have your first omnicoin address in the "Receive Coins" tab.


If you need more addresses click the "New Address" button. You can create as many addresses as you like and add a label for each address for easy reference.

• Export your address to a CSV file using the "Export" button. You can keep electronic and hard copies of your addresses. No one can do anything with them except send you Omnicoins.
  

RECEIVE OMNICOINS
To receive Omnicoins you just have to click on your Address and click "Copy Address".


SEND OMNICOINS
To send Omnicoins you just have to click on "Send Coins" tab and insert the recipient address, a label (optional) and the amount of OMC.

SECURITY TIPS:

ENCRYPT THE WALLET

This step is optional, but is highly recommended. It helps prevent someone from accessing your private keys should they steal your wallet.
Go to Settings >Encrypt Wallet and insert a passphrase.

Note: After encrypting wallet, it will not ask you for the password whenever you start the program. It will only ask for the password whenever you try to withdraw/send Omnicoins.


PRINT PRIVATE KEYS

Each Omnicoin address has a private key associated with it, the private key is required to send Omnicoins from the address to another address. You should keep a copy of your private keys on paper (paper wallet) and store it somewhere safe. You can later use your paper wallet to restore your wallet, should you lose your wallet file.
Go to Help>Debug Window>Console and type:

Code

dumpprivkey your-omnicoin-address

The private key will be displayed in the debug window. Repeat for each address.
Copy the results to notepad and print. Delete the notepad file!

MOVE YOUR WALLET OFFLINE - BACKUP YOUR WALLET

The wallet file contains the private keys we just printed for your Omnicoin addresses. As mentioned, these are required in order to send Omnicoins. If anyone obtains this file they can steal your coins. Encrypting the file will help in preventing someone from accessing the private keys, but the best way is to take the file offline!

• Close Omnicoin-Qt.
  
• Locate your wallet.dat file. The file should be in the following locations in Windows and Linux respectively:
  - Windows users:
  C:\Users\[YOUR USERNAME]\AppData\Roaming\Omnicoin\wallet.dat
  
  - Linux users:
  /home/[YOUR USERNAME]/.omnicoin/wallet.dat
  
  
• Move your wallet.dat file to several offline places (cold storage), such as 4x USB sticks.
  
• Ensure you do not leave a copy of wallet.dat on your computer, cut and paste it to the last USB stick.
  

TROUBLESHOOTING:

OUT OF SYNC - WALLET NOT SYNCING

There are a couple possible fixes for this.

• Run Omnicoin for the first time so that the Omnicoin data directory is created. After that, create the configuration file for OMC using the following code:
  

Code

rpcuser=user
rpcpassword=password
addnode=204.44.122.123
addnode=192.99.42.164
addnode=192.99.42.206
addnode=192.99.42.238
rpcport=43555
server=1
daemon=1

(daemon=1, server=1, rpcuser and rpcpassword are completely useless if you just need to use it as a wallet.
In fact, running it with server=1 is less secure than not doing it, as that starts the RPC server)

Save this as omnicoin.conf and drop this into:
Windows: %AppData%\Omnicoin (Expanded to C:\Users\Username\AppData\Roaming\Omnicoin Usually)
Mac: ~/Library/Application Support/Omnicoin/
Linux: ~/.OmniCoin

• If you've already created the Omnicoin configuration file, there may be a problem with the synced blocks. Be sure to back up your wallet by copying the wallet.dat file to a secure location and/or use the "dumpprivkey <omnicoin address>" command from Help>Debug Window>Console, and saving the private keys somewhere safe. I personally recommend doing both. After that's done, delete the data directory where the omnicoin.conf file is located, and re-run the Omnicoin application to regenerate the data directory. Close it again, and drop the configuration file back in, along with your wallet.dat file (or import them via the console's "importprivkey <private key>" command) If it's still not syncing on the next run.
  
  
• You may have the wrong version of Omnicoin. Aurora's version was a nice start, but we've since nuked everything, so all old Omnicoins, and the entire blockchain is incompatible with the new version (Basically, if you downloaded it before April 5th, 2014, it's the wrong version). Either redownload it from this thread, or from the Omnicoin Website, and repeat the data directory nuking from the previous fix, run the new binary, and go from there. That should fix it all up.
  
  
• If it's only out of sync by less than 24 hours, it may be a system time issue. You will have to resynchronize your time server, and/or make sure you choose the right timezone. For Windows, this can be done by running 'w32tm /RESYNC'. If you get a connection error, try running the following snippet.
  
  Code

  w32tm /UNREGISTER
w32tm /UNREGISTER
w32tm /REGISTER
  Yes, two /UNREGISTER commands is indeed correct. (Thanks Cryptic™ for the tip)
  

EDIT omnicoin.conf

All command-line options (except for -datadir and -conf) may be specified in a configuration file, and all configuration file options may also be specified on the command line. Command-line options override values set in the configuration file.

The configuration file is a list of setting=value pairs, one per line, with optional comments starting with the '#' character.

The configuration file is not automatically created; you can create it using your favorite plain-text editor. By default, Omnicoin (or omnicoind) will look for a file named 'omnicoin.conf' in the Omnicoin data directory, but both the data directory and the configuration file path may be changed using the -datadir and -conf command-line arguments.
Here is a sample omnicoin.conf file:

Code

# omnicoin.conf configuration file. Lines beginning with # are comments.

# Network-related settings:

# Run on the test network instead of the real omnicoin network.
#testnet=0

# Connect via a socks4 proxy
#proxy=127.0.0.1:9050

######
##      Quick Primer on addnode vs connect      ##
##  Let's say for instance you use addnode=4.2.2.4      ##
##  addnode will connect you to and tell you about the      ##
##    nodes connected to 4.2.2.4.  In addition it will tell ##
##    the other nodes connected to it that you exist so     ##
##    they can connect to you.      ##
##  connect will not do the above when you 'connect' to it. ##
##    It will *only* connect you to 4.2.2.4 and no one else.##
##      ##
##  So if you're behind a firewall, or have other problems  ##
##  finding nodes, add some using 'addnode'.      ##
##      ##
##  If you want to stay private, use 'connect' to only      ##
##  connect to "trusted" nodes.      ##
##      ##
##  If you run multiple nodes on a LAN, there's no need for ##
##  all of them to open lots of connections.  Instead      ##
##  'connect' them all to one node that is port forwarded   ##
##  and has lots of connections.      ##
##      Thanks goes to [Noodle] on Freenode.      ##
######

# Use as many addnode= settings as you like to connect to specific peers
#addnode=204.44.122.123
#addnode=192.99.42.164
#addnode=192.99.42.206
#addnode=192.99.42.238

# ... or use as many connect= settings as you like to connect ONLY
# to specific peers:
#connect=69.164.218.197
#connect=10.0.0.1:8333

# Maximum number of inbound+outbound connections.
#maxconnections=

# JSON-RPC options (for controlling a running Omnicoin/omnicoind process)

# server=1 tells Omnicoin-QT to accept JSON-RPC commands.
#server=0

# You must set rpcuser and rpcpassword to secure the JSON-RPC api
#rpcuser=HackForums
#rpcpassword=YourSuperGreatPasswordNumber_DO_NOT_USE_THIS_OR_YOU_WILL_GET_ROBBED_385593

# How many seconds omnicoin will wait for a complete RPC HTTP request.
# after the HTTP connection is established.
#rpctimeout=30

# By default, only RPC connections from localhost are allowed.  Specify
# as many rpcallowip= settings as you like to allow connections from
# other hosts (and you may use * as a wildcard character).
# NOTE: opening up the RPC port to hosts outside your local
# trusted network is NOT RECOMMENDED, because the rpcpassword
# is transmitted over the network unencrypted.
#rpcallowip=10.1.1.34
#rpcallowip=192.168.1.*

# Listen for RPC connections on this TCP port:
#rpcport=8332

# You can use Omnicoin or omnicoind to send commands to Omnicoin/omnicoind
# running on another host using this option:
#rpcconnect=127.0.0.1

# Use Secure Sockets Layer (also known as TLS or HTTPS) to communicate
# with Omnicoin -server or omnicoind
#rpcssl=1

# OpenSSL settings used when rpcssl=1
#rpcsslciphers=TLSv1+HIGH:!SSLv2:!aNULL:!eNULL:!AH:!3DES:@STRENGTH
#rpcsslcertificatechainfile=server.cert
#rpcsslprivatekeyfile=server.pem

# Miscellaneous options

# Set gen=1 to attempt to generate omnicoins
#gen=0

# Pre-generate this many public/private key pairs, so wallet backups will be valid for
# both prior transactions and several dozen future transactions.
#keypool=100

# Pay an optional transaction fee every time you send omnicoins.  Transactions with fees
# are more likely than free transactions to be included in generated blocks, so may
# be validated sooner.
#paytxfee=0.00

# Allow direct connections for the 'pay via IP address' feature.
#allowreceivebyip=1

# User interface options

# Start Omnicoin minimized
#min=1

# Minimize to the system tray
#minimizetotray=1

OFFICIAL NODES

List of official nodes to add (optional):

Code

addnode=204.44.122.123
addnode=192.99.42.164
addnode=192.99.42.206
addnode=192.99.42.238

POINTS TO REMEMBER

• You can create as many new addresses as you like. Using a different address each time helps keep you anonymous.
  
• You can be anonymous with adequate precautions.
  
• You cannot send OMC to an invalid address. Typos are not a worry as the payment will refuse to send.
  
• The wallet file holds the keys that allow spending and thus the computer should be protected from the risk of loss and theft.
  
• Leaving Omnicoin open improves connectivity for the network and ensures that you don't fall behind on the block chain.
  

[Grumpy Otaku]

There is an official tutorial already made.

[Doctor Blue]

There are some official nodes coming up soon, you might want to add a small section about editing omnicoin.conf, which is actually the part most people get wrong.

There is an official tutorial already made.

No

[VirusTotal]

There are some official nodes coming up soon, you might want to add a small section about editing omnicoin.conf, which is actually the part most people get wrong.

No

Yeah I'm editing right now the troubleshooting part like out of sync etc.

---

OK UPDATED!!!

Added some screenshots and new things

[xhflhkeuhwguu34]

There is an official tutorial already made.

link pls

Looks nice. Good job OP. 👍

[Viralboost.io]

The wallet file contains the private keys we just printed for your Omnicoin addresses. As mentioned, these are required in order to send Omnicoins. If anyone obtains this file they can steal your coins. Encrypting the file will help in preventing someone from accessing the private keys, but the best way is to take the file offline!
Close Omnicoin-Qt.
Locate your wallet.dat file. The file should be in the following locations in Windows and Linux respectively:
- Windows users:
C:\Users\[YOUR USERNAME]\AppData\Roaming\Litecoin\wallet.dat

- Linux users:
/home/[YOUR USERNAME]/.litecoin/wallet.dat

Edit /Litecoin/ to /Omnicoin/

[g4t3k33p3r]

The wallet file contains the private keys we just printed for your Omnicoin addresses. As mentioned, these are required in order to send Omnicoins. If anyone obtains this file they can steal your coins. Encrypting the file will help in preventing someone from accessing the private keys, but the best way is to take the file offline!
Close Omnicoin-Qt.
Locate your wallet.dat file. The file should be in the following locations in Windows and Linux respectively:
- Windows users:
C:\Users\[YOUR USERNAME]\AppData\Roaming\Litecoin\wallet.dat

- Linux users:
/home/[YOUR USERNAME]/.litecoin/wallet.dat

Edit /Litecoin/ to /Omnicoin/

Also I have seen many people have their coins stolen for not taking the extra few minutes to encrypt your private keys. The option is built in to most qt software.

[VirusTotal]

The wallet file contains the private keys we just printed for your Omnicoin addresses. As mentioned, these are required in order to send Omnicoins. If anyone obtains this file they can steal your coins. Encrypting the file will help in preventing someone from accessing the private keys, but the best way is to take the file offline!
Close Omnicoin-Qt.
Locate your wallet.dat file. The file should be in the following locations in Windows and Linux respectively:
- Windows users:
C:\Users\[YOUR USERNAME]\AppData\Roaming\Omnicoin\wallet.dat

- Linux users:
/home/[YOUR USERNAME]/.omnicoin/wallet.dat

Thanks ;) Sorry for the error. Edited 👍

[chaddiablo]

Either a mistake or this thread was coppied from some where else.
You have the word bitcoin.

CREATE AN ADDRESS
Your wallet will automatically have your first bitcoin address in the "Receive Coins" tab.

[VirusTotal]

Either a mistake or this thread was coppied from some where else.
You have the word bitcoin.

Edited, thanks for The report! Yeah i made a few mistakes

[Doctor Blue]

Actually you need to strip away a lot of things in the config file.
Crypto Miner won't listen, but daemon=1, server=1, rpcuser and rpcpassword are completely useless if you just need to use it as a wallet.
In fact, running it with server=1 is less secure than not doing it, as that starts the RPC server.

To be precise...
You only need the addnode lines, the rest is useless.

Also remember to take caps into account when writing out paths for *NIX.
Windows: %AppData%\Omnicoin (Expanded to C:\Users\Username\AppData\Roaming\Omnicoin Usually)
Mac: ~/Library/Application Support/Omnicoin/
Linux: ~/.omnicoin

Should be
Windows: %AppData%\OmniCoin (Expanded to C:\Users\Username\AppData\Roaming\OmniCoin Usually)
Mac: ~/Library/Application Support/OmniCoin/
Linux: ~/.OmniCoin

Now why, you might ask. Because CTRL+H is a powerful tool and some people just aren't ready for it.

[VirusTotal]

Actually you need to strip away a lot of things in the config file.
Crypto Miner won't listen, but daemon=1, server=1, rpcuser and rpcpassword are completely useless if you just need to use it as a wallet.
In fact, running it with server=1 is less secure than not doing it, as that starts the RPC server.

To be precise...
You only need the addnode lines, the rest is useless.

Also remember to take caps into account when writing out paths for *NIX.
Windows: %AppData%\Omnicoin (Expanded to C:\Users\Username\AppData\Roaming\Omnicoin Usually)
Mac: ~/Library/Application Support/Omnicoin/
Linux: ~/.omnicoin

Should be
Windows: %AppData%\OmniCoin (Expanded to C:\Users\Username\AppData\Roaming\OmniCoin Usually)
Mac: ~/Library/Application Support/OmniCoin/
Linux: ~/.OmniCoin

Now why, you might ask. Because CTRL+H is a powerful tool and some people just aren't ready for it.

Edited it, thanks for the report.
35car

[Knar.]

Very well done, i'm sure this will help people as i've seen many having problems.

[VirusTotal]

Very well done, i'm sure this will help people as i've seen many having problems.

Thanks dude!!!
Tell me if you think there is more to add/edit ;)

[Knar.]

Add these new nodes to the Config file.

addnode=192.99.42.164
addnode=192.99.42.206
addnode=192.99.42.238

Yes please do, they're the new ones created by DoctoreBlue.