Skip to main content

Create Wsjtx-Portable (Version 0.5)

The portable wsjt-x device in pocket is now named. As the title says, it's simply called Wsjtx-Portable.

Wsjtx-Portable is a Wsjt-X program-only device in pocket. I wanted to make it available for use in SOTA, qrp, automobiles and outdoor.

Caution : Wsjtx-Portable should have experience using wsjtx. used this great program, please install it for PC first. Once you are familiar with how to use wsjtx, we recommend using Wsjtx-Portable. This is because using a small size LCD is more inconvenient than a PC program.

The following link explains why created WSJTX-Portable.

Why did you set the version to 0.5? It is not finished yet. Wsjtx-Portable will continue to improve.

Are you ready for funny digital communication?
I will suggest two ways. The hard way and the easiest way.
The hard way is to follow the settings one by one.  The easiest way is to write the image I uploaded to the sdcard. Both methods are good.

The Wsjtx-Portable 3.5LCD version requires the following items:

  A.Raspberry Pi 3
  Raspberry Pi 2 is also available. but slow, i recommend Raspberry pi 3.
  I used RPI3 and RPI2 because I had quite a lot of Raspberry pi 2 that I used in my graduate lectures.

 B.3.5 LCD
 I tested two 3.5 LCDs and confirmed that they all work.
 If you have a different model, I would be grateful if you can experiment and let me know if it works. I had two 3.5LCDs, but fortunately it all worked. But the up and down has changed, but it does not matter much.


 C.Micro sdcard over 8Gb
  If you choose the second installation (easy) of the two installation methods, 16Gb is recommended.
 I create an image using an 8GB SD card. Even the same 8Gb SD card is slightly different in size.

 D.USB Sound card
 Anything that is available in Raspberry Pi is good.
 I chose the cheapest. ($1 ~ $2)

 E.Keyboard,  Mouse and cables... (when setup)
  Use for installation only. You do not have to buy a new one.

*There are two ways to install. If you want to install one by one, please read 2. Read 3 for quick and easy installation.

2.Install (Hard way - Step by Step)
  2-1. Raspberry pi install
   Click on the link below to install Raspberry pi.

   I also open the link above and follow.
   The images below are the pictures I took during the installation.

   Raspberry pi OS Download

   Write OS Image to sdcard by Win32DiskImager



  LCD is not yet mounted.

  Connect SSH

  Login : pi / raspberry

  IP Setup -Set the ip you want.

  set pi password
  password is forham
  alos Wsjtx-Portable Image has passwrod 'forham'


  2.2 Install Wsjt-x
  Install Wsjt-X by referring to the link below.

  I also refer to the link above to proceed with the installation.
  I only install Wsjt-X for quick installation.

  type 'sudo apt-key adv –keyserver –recv-keys 862549F9'

  type 'sudo nano /etc/apt/sources.list'
  add 1 line
  deb trusty main

  type 'sudo apt-get update' [enter]

  Add Software

  Search wsjtx

  Check Version 1.8.0 <-- very important,
   If one of the above procedures is incorrect, the version will be 1.1 or 1.0.
   If you do not have a version starting with 1.8, do not install it.

  check wsjtx 1.8.0

   Click to Apply button

  input pi password -> forham

   When all the installation is complete, click the OK button.

 2.3 Install Virtual Keyboard
   sudo apt-get install matchbox-keyboard

 2.4 Install LCD3.5 Driver
  Install the LCD 3.5 driver you have purchased.
  The following procedure may not be compatible with your LCD.
  I followed the link below and it worked perfectly. Both types of LCDs

  sudo rm -rf LCD-show
  git clone

  chmod -R 755 LCD-show
  cd LCD-show/ 

  All LCD driver installation is finished. Simple, right?
  Now we will try switch to 3.5 LCD screen.
  sudo ./LCD35-show

  After a while, the LCD should display as below. If the screen below does not appear, you need to find the driver for your LCD.

  If the test is successful, switch to HDMI mode again.

  cd LCD-show
  sudo ./LCD-hdmi

 2.5 Setup Mouse right click emulation
 cd /usr/share/X11/xorg.conf.d

 sudo nano 40-libinput.conf

 append 3 Lines in "libinput touchscreen catchall" section
    Option "EmulateThirdButton" "1"
    Option "EmulateThirdButtonTimeout" "750"
    Option "EmulateThirdButtonMoveThreshold" "30"


  cd LCD-show
  sudo ./LCD35-show

  If you have switched to the LCD 3.5 screen, press and hold the touch screen on the LCD. The menu should appear as the right button is pressed as shown below.
  This function is essential when you go outdoors with Wjstx-Portable.

  Switch the screen back to HDMI mode.

  2.6 Setting wsjt-x
  Shutdown and Connect sound card, CAT Communication cable, and booting.
  The wsjtx setting can be found on the Internet.
  If you are using uBITX, you can refer to the link below.

  After completing the wsjt-x setup, finish the test until communication is possible.

  Below is an example of my setup. Make your own settings because the situation of your radio, sound card, etc. is different.





   wsjtx test

   wsjt-x Disable Splash window - Option
   When you first install the wsjt-x program, the Splash window appears. Splash Windows can not be closed on a small LCD 3.5. Of course, if you wait quite a long time, it disappears by itself. Read the Splash Windows and check the Checkbox at the bottom to prevent it from reopening. I thought it was polite to keep Splash Windows.
  2.7 Install Wsjtx-Portable

  download file


download Link

Download icon Click (unknown character)

show in folder

mkdir wsjtxp
cd wsjtxp

cp ../Downloads/ .

you can saw this files.

Run the script
I have created a script that copies the files needed to run Wsjtx-Portable to a directory.
You can run the script with the following command,
If you want to copy manually, open the script by text editor. You can see where the files should be located.


 If the script is successful, you can see that the icon is created on the desktop as shown below.

2.8 Settings for using Wsjtx-Portable program
  - Hide taskbar

  Check 'Minimise panel when not in use', click to close button

  - Autorun & disable screensaver
  Here is an option. Just follow the person you want.

  nano ~/.config/lxsession/LXDE-pi/autostart

  Append 4 Lines

  @xset s noblank
  @xset s off
  @xset -dpms

2.9 Test
 Change to LCD3.5 Mode
 cd ~/LCD-show
 sudo ./LCD35-show

 The video below is Wsjtx-Portable, which I installation while posting this article.
  Congratulations. All the installation process is complete.

3.Easy Install (Using already installation Wsjtx-Portable Image)
  3-1. Downalod Wsjtx-Portable Image
I knew I could not download it later. So I temporarily uploaded wsjtx portable image file on my server.

( 1.76GB)

Extract Zipfile

The size of wsjtxp05.img is 7.4gb

3-2. Copy Image
Use win32DiskImager to copy Img to the sd card.

 win32DiskImager can be downloaded by clicking the link below.

 You can see how to use Win32DiskImager in the link below.




 3-3. Boot and Change to HDMI 
 Connect LCD, HDMI Cable, CAT Cable, Keyboard, Network Cable... and Power Connect
 This step is for setting wsjtx on the big screen.

  I've put virtual keyboard and mouse right button functions in Image. so You can use them to configure on 3.5LCD.  However, it is not recommended. I'm uncomfortable with the small screen. Just use it as an emergency at outdoors.

  Sometimes I set it up to 3.5 LCD because it is annoying to connect the keyboard and monitor to the RPI at home.
 If you like to touch a small screen, you can skip this step and the next step. You can also make settings in the Configuration menu of Wjstx-Portable.
 Please watch the video below.

 The first time you turn the power on, it boots and automatically launches Launcher Portable for Ham.

  Press Stop before Wstx-Portable is executed.
 Press the Change HDMI button.

 After a while the Launcher Portable will appear on the HDMI monitor.

 Press Stop Button and then press close button.

 3-4.Setup Wsjtx
 The wsjtx setting can be found on the Internet.
 If you are using uBITX, you can refer to the link below.
  See Section 2.6 above.
 I recommend that you complete the communication test.

 3-5. Finish
  Once you have configured and tested Wsjtx, run Launcher Portable.
  (Double click the Launcer Portable icon on the desktop.)

 Click the Change LCD3.5 button.

 You can see Launcher Portable running on 3.5LCD and Wsjtx-Portable running after a while.
You have completed your own Wsjtx-Portable according to Installation Method 2 or Installation Method 3.
Wsjtx-Portable was created earlier, but it seems that it took more time to create this document.  After a little rest, I will post the Wsjtx-Portable manual.
It is also recommended to try beforehand. If there is a problem, just copy Imgage again.

Thank you for reading.

Ph.D Ian Lee


  1. Replies
    1. Thanks for testing.
      I hope your new 3.5LCD will arrive quickly.

  2. Thank you Ian, here is photo of my homebrew uBITX rx and RPI setup


    1. Mashesh

      I watched the picture later. It is so cool.
      If you have time, I would like to see more pictures.

      Ian KD8CEC

  3. Would a 5” LCD work as well? What modifications would need to br made for this to work? 3.5” is such a small screen. Thanks!

    1. Stephen
      The 5 "LCD was not in the plan early on. But I have decided to make 5 "Wsjtx-Portable for my needs with many users.
      But as you can see, the full version of Wsjt-x 1.9 is coming soon. So I'm hold for the Wsjtx-Portable project for a while.
      When version 1.9 is released, I want to make Wsjtx-Portable a new version.
      At that time, I expect to make a 5 "LCD version.

      Ian KD8CEC

  4. What's the admin password of raspbian in the img image?
    Do you know how to activate gps and internet connection? Thanks

  5. Err:2 trusty InRelease
    The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 5794D54C862549F9
    Reading package lists... Done
    W: GPG error: trusty InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 5794D54C862549F9
    E: The repository ' trusty InRelease' is not signed.
    N: Updating from such a repository can't be done securely, and is therefore disabled by default.
    N: See apt-secure(8) manpage for repository creation and user configuration details.


Post a Comment

Popular posts from this blog

How to upgrade uBITX Firmware

uBITX is based on Arduino Nano. So uBITX's firmware upgrade method is the same as Arduino.
There are two ways to upgrade the firmware of uBITX.

The first is to compile the source from the Arduino IDE, and the second is to upload the compiled hex file using the Firmware Upgrade Tool.

I'll show you how to upload a compiled hex file as a second method.

1.Connect the uBITX's USB cable to the computer.

2.Run Device Manager on your computer.
  The way to open the Device Manager for each OS Version differs slightly.
  In most Windows, you can easily launch the Device Manager by running.

  On your computer, press the Windows key + R.

 Type devmgmt.msc and press OK Button.

On most operating systems, there will be a serial port named Ports with CH340. If so, the next step is skipped.

If the serial port is not installed as below, you need to install the driver.

Included in uBITX is the Adonano, which uses the CH340 USB To UART part.

Download the latest CH340 driver from the Internet.

CAT Support uBITX Firmware CEC Version 1.06 Release (Added WSPR)

uBITX Firmware CEC Version v1.06 (changed v1.061)

I deployed 1.06 and received feedback from WSPR's beta tester, Philip (G7JUR).
It was a problem that the LPF was not automatically selected according to band selection during WSPR transmission.

Version 1.08 has been released.

I modified it soon and changed uBITX Firmware CEC Version to 1.061.
uBITX Manager also changed Version to 1.01.


I released version 1.06 which added WSPR function to uBITX.
Beta testers have been very helpful when embedding WSPR functionality. WSPR will continue to improve in the future.

By using WSPR before and after QSO, you can check where your uBITX is spreading all over the world.  If uBITX Manager is used to put WSPR information into uBITX, uBITX no longer needs any external device to transmit WSPR.

The uBITX group's excellent tester also shared a …

CAT Support uBITX Firmware CEC Version 1.01 Release(Changed from v1.0)

CAT Support uBITX Firmware CEC Version 1.01  Release (Changed from v1.0)

uBITX Firmware CEC Version 1.06 has been released.
Please click the link below.

This version of the concept is an upgrade without hardware modifications. No hardware modifications are required to use this firmware. Continuous release and testing has been done in the uBITX group. I tried to put only the basic functions that an HF transceiver should have. The features have been upgraded with the advice of people who have great ideas in the uBITX group.
It was a project that started to contribute to the original source in github. The project was intended to fix some simple bugs and request merge to the original source. And I was planning to delete the project. At the beginning of the project there was a bit of discussion about this in the uBITX group.
Since then, I've keeping the original source type to allow code share with any user fork…