Running¶
Hint
Since v0.4.1 Converter CSV comes with pre-built binaries for Windows, Linux and macOS. You can download the latest version from
GitHub Releases page.
You can still install it with pip and build it from source code if you want.
If you decided to download pre-build version follow Build version instruction. If you decided to install from PyPI follow Source version instruction.
Build version¶
Go to GitHub Releases page.
Select and download from the Assets list the ZIP archive with
-windowssuffix.In the Terminal run, e.g., below command to verify the checksum of downloaded file:
Get-FileHash .\LimberDuck-Converter-CSV-vX.Y.Z-windows.zip -Algorithm SHA256Important
The output should match the checksum provided in the GitHub Releases page!
Unzip the archive.
Go to unzipped folder and click on
LimberDuck Converter CSV.exefile to start Converter CSV.If you see Windows message protecting from opening, click on More info and then click on Run anyway.
Go to GitHub Releases page.
Select and download from the Assets list the ZIP archive with
-linuxsuffix.In the Terminal run, e.g., below command to verify the checksum of downloaded file:
sha256sum LimberDuck-Converter-CSV-vX.Y.Z-macos-arm64.zipImportant
The output should match the checksum provided in the GitHub Releases page!
Unzip the archive.
Go to unzipped folder and click on
LimberDuck-Converter-CSVfile to start Converter CSV.
Error
If you run Converter CSV and window does not open, go to Terminal and run LimberDuck-Converter-CSV, if you see below error:
~$ LimberDuck-Converter-CSV
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl, xcb.
Aborted (core dumped)
Run below to fix it:
sudo apt-get install --reinstall libxcb-xinerama0
Click on LimberDuck-Converter-CSV file again to start Converter CSV.
Go to GitHub Releases page.
Select and download from the Assets list the ZIP archive with
-macos-arm64suffix if you have MacBook with Apple Silicon, if Intel based choose-macos.In the Terminal run, e.g., below command to verify the checksum of downloaded file:
sha256sum LimberDuck-Converter-CSV-vX.Y.Z-macos-arm64.zipImportant
The output should match the checksum provided in the GitHub Releases page!
Unzip the archive.
Go to unzipped folder and run
LimberDuck Converter CSV.appfile to start Converter CSV.If you see macOS message protecting from opening, open Terminal and run below command:
xattr -dr com.apple.quarantine LimberDuck\ Converter\ CSV.appClick on
LimberDuck Converter CSV.appfile again to start Converter CSV.
Source version¶
Once you have Converter CSV installed you can run it in Terminal with command:
converter-csv
Attention
Remember to open your Python virtual environment first, if you decided to use it.
If you use virtualenvwrapper,
mentioned in the Installation instruction,
you can do it with the command workon <name_of_your_virtualenvironment>.
To exit your Python virtual environment, use the command deactivate.
Tip
Optionally for Linux and macOS run with & at the end to start the process in the background.
converter-csv&
Make a shortcut to Converter CSV to run it even faster.
Run
wherecommand incmdto getyour_path_to_converter-csvwhere converter-csv.exeCopy path return in previous command.
Go, e.g., to Desktop.
Right click on Desktop and choose
New > Shortcut.Paste returned path.
Click
Next.Click
Finish.
Run
whichcommand in Terminal to getyour_path_to_converter-csvwhich converter-csvRun
lncommand in Terminal with path return in previous command to create a link:ln -s your_path_to_converter-csv ~/Desktop/
Error
If you have installed Converter CSV on Ubuntu without python virtual environment, and see below error:
~$ converter-csv
converter-csv: command not found
Add below to ~/.bashrc to fix it:
# set PATH so it includes user's private ~/.local/bin if it exists
if [ -d "$HOME/.local/bin" ] ; then
PATH="$HOME/.local/bin:$PATH"
fi
Error
If you run Converter CSV and see below error:
~$ converter-csv
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, wayland-egl, wayland, wayland-xcomposite-egl, wayland-xcomposite-glx, webgl, xcb.
Aborted (core dumped)
Run below to fix it:
sudo apt-get install --reinstall libxcb-xinerama0
Run
whichcommand in Terminal to getyour_path_to_converter-csvwhich converter-csvOpen
binfolder whereconverter-csvis located.Right click on
converter-csvand choose an optionMake alias.Move your alias, e.g., to Desktop.