Setup DevTerm to be a cool non-GUI device

Related tags

Hardwarelinuxdevterm
Overview

DevTerm hobby project

I bought this amazing device: DevTerm A-0604. It has a beefy ARM processor, runs a custom version of Armbian, embraces Open Source / Open Hardware philosophy and looks dope!

It also has LightDM + xfce as a GUI but it's kinda boring to use this awesome retro-looking device with any kind of a graphical interface. Let's try to set it up for a serious business and a maximum entertainment without any GUI - just how it was in the good old days.

Last Linux distro I've touched (not counting servers) was Red Hat Linux 9 (not RHEL!). I know nothing about modern linuxes + I always forget all the voodoo you have to do to make them work. So here I'll be storing my notes and useful scripts as I go with this hobby project

Roadmap

  • disable GUI
  • enable ssh connection
  • connect to home wifi
  • basic scripts (battery charge and brightness control)
  • render UTF, Cyrillic, Japanese in TTY
  • battery indicator in zsh prompt
  • nice setup for tmux (themes, plugins)
  • email client (gmail, protonmail)
  • games: nethack
  • games: dcss
  • twitter client
  • hckrnews client
  • reddit client
  • stonks
  • IDE / code editor
  • text editor
  • rust
  • can I see pictures in the TTY?
  • what about video?
  • music / spotify player
  • gamepad to scroll text in terminal
  • soluiton for browser
  • start fdterm+fcitx on load
  • bg image in fbterm
  • japanese input in tty
  • google translate in terminal
  • auth by usb stick
  • plug a mini cassette recorder, do some magic to let me store data using cute tiny mini audio-cassettes.. yum!

Notes

  1. Terminal. Standard TTY has a very limited capabilities to render fonts. Had troubles to render Japanese characters (kanji, hirogana and katakana). Got success with using fdterm with Iosevka Term and Noto Sans JP fonts. Downloaded them and copied into /usr/share/fonts/(truetype|opentype) and update ~/.fbtermrc. If the first font doesn't contain the glyph for the rendering character, it will try second font and etc (1). (Still need to try to figure out how to autostart fdterm)

  2. To connect to WiFi I've tried wpa_cli but you need to be really smart to use it. Not my case. Fallbacked to use nmcli and it works like a charm

  3. Browser. Had some hopes for Browsh but it's super slow (uses headless Firefox behind the scenes) and rendering getting borked in fdterm. Have to use lynx for now, and my Macbook

  4. Translations. After quick search was able to find libtranslate-bin but there were no builds for ARM64 and I was about to start building it from sources. However, looked for alternatives in the apt repo and found translate-shell. Works amazingly well for my needs

  5. There is a cool zsh plugin as part of oh-my-zsh called battery. To make it work you need to install acpi and update your prompt. Works flawlessly but I want to use battery indicator in tmux

  6. Games. DCSS is a cool roguelike crawler. Doesn't have ARM64 binary, got the source, followed the instructions and built it without any problems. However attempting to start it throws an error Terminal too small because it needs min height of 24 lines (DevTerm is only 19). Can try to change this but will that make it unplayable?

  7. Used this guide to change the way gamepad on DevTerm keyboard works

  8. Installed gpm (using this) to enable mouse in tty. Didn't need to setup anything. It just works

  9. Software - Reddit client. Although rtv is discontinued - it still works better than alternatives. Can't log in under my user but it doesn't matter much.

  10. Games. Nethack just works!

  11. CPU scaling. Clockworkpi made a script to adjust CPU/GPU cores dynamically

  12. Spotify. You can get spotifyd complied from sources without a problem, just follow the official docs - that allows to play spotify on a devterm. Now, there is spotify-tui to control it via the terminal (to register correctly I had to tunnel the dev server as lynx wasn't able to render the spotify auth page. App itself works but still missing a lot of features.

Japanese input method in terminal

I stumbled upon this good video where Brodie Robertson talks about input method frameworks, input method engines and shows how to setup fcitx with fcitx-moz to enable Japanese input method for Arch linux.

However we need to make all of it working in our terminal. Luckily for us there is fbterm support and as a double win - we have all needed packages in Armbian repo. So I've installed sudo apt install fcitx fcitx-mozc fcitx-frontend-fbterm fcitx-ui-classic.

Configuration in ~/.config/fcitx/config seems pretty odd. I wasn't able to make it work with any other trigger key except for the default one (Ctrl+Space). However I changed SwitchKey to be L_ALT (instead of defaule L_SHIFT) and it made my life better.

To be able to use Ctlr+Space combination I had to update permissions for fbterm by executing setcap 'cap_sys_tty_config+ep' /usr/bin/fbterm

Then to start fbterm with fcitx you simply run fcitx-fbterm-helper -l. Press Ctrl+Space to enable it and then Alt to switch between US and JA input methods.

Set background image in terminal

We have this good guide that I followed to make the magic happen. We need to build fbv from sources and for that we need to:

  • get stock libjpeg dev by using sudo apt-get install libjpeg-dev
  • build libungif from sources:
git clone https://github.com/Distrotech/libungif.git
autoreconf -f -i
./configure
make 
sudo make install
  • build old libpng (1.2) because fbv doesn't like the latest one Armbian repo has
# get .tar.gz from https://sourceforge.net/projects/libpng/
tar xfv 
   
    
./configure
make 
sudo make install
sudo ldconfig

   

Now it's time to get and build fbv:

wget http://s-tech.elsat.net.pl/fbv/fbv-1.0b.tar.gz
tar xfv fbv-1.0b.tar.gz
./configure
sudo checkinstall

Now according to the fbterm manual, this is the script we can create to run fbterm with the background image:

#!/bin/bash

# fbterm-bi: a wrapper script to enable background image with fbterm
# usage: fbterm-bi /path/to/image fbterm-options

echo -ne "\e[?25l" # hide cursor

fbv -ciuker "$1" << EOF
q
EOF

shift
export FBTERM_BACKGROUND_IMAGE=1
exec fbterm "$@"

I've slightly modified it and put in this repo as ./scripts/fbstart. Remember, we actually don't start fbterm directly but run it via fcitx-fbterm-helper instead. If you are doing the same thing, you would also would like to edit /usr/bin/fcitx-fbterm-helper to comment all echo lines there. Otherwise those messages will become the part of your background.

One more thing: for some reason my fbterm requires a counter clockwise rotation to render itself correctly, so I had to rotate the image as well.

At the end it looks like this:

Login & sudo via Yubikey (USB Security Key)

I have Yubikey 5 NFC so it was logical to set it up with DevTerm.

First you need to generate One Time Password (OTP) and upload it to Yubikey Cloud, then you have to generate API keys - store it somewhere secure.

For the same step you can download and use Yubikey Manager app on your other machine. I used it to setup long button press on a key to return the OTP

Then you will have to get yubico-pam. I've built it myself following the instruction in the README. But to do that you will have to build a fee other dependencies first. Namely yubico-c and yubico-c-client

And to build them I had to install quite a few libraries (maybe even missing something):

sudo apt-get install libcurl4-openssl-dev libpam-dev help2man libxslt1-dev docbook-xsl xsltproc libxml2-utils asciidoc

After that follow the configuration instructions for yubico-pam, add to /etc/pam.d/sudo and /etc/pam.d/login this (you can remove debug later after you verify that it works:

auth sufficient pam_yubico.so id=[Your API ID] debug

then create ~/.yubico/authorized_yubikeys with your username and Yubikey ID (that's the info from "Public identity" field when you generate your OTP password)

username:
   

   

then move pam_yubico.so to /lib/security/

mv /usr/local/lib/security/pam_yubico.so /lib/security/

and that's it! Next time you login/sudo you will prompted by YubiKey for 'USERNAME': and you just need to simply touch your key. You should see something like this:

debug: pam_yubico.c:943 (parse_cfg): called.
debug: pam_yubico.c:944 (parse_cfg): flags 32768 argc 2
debug: pam_yubico.c:946 (parse_cfg): argv[0]=id=00000
debug: pam_yubico.c:946 (parse_cfg): argv[1]=debug
debug: pam_yubico.c:947 (parse_cfg): id=00000
debug: pam_yubico.c:948 (parse_cfg): key=(null)
debug: pam_yubico.c:949 (parse_cfg): debug=1
debug: pam_yubico.c:950 (parse_cfg): debug_file=1
debug: pam_yubico.c:951 (parse_cfg): alwaysok=0
debug: pam_yubico.c:952 (parse_cfg): verbose_otp=0
debug: pam_yubico.c:953 (parse_cfg): try_first_pass=0
debug: pam_yubico.c:954 (parse_cfg): use_first_pass=0
debug: pam_yubico.c:955 (parse_cfg): always_prompt=0
debug: pam_yubico.c:956 (parse_cfg): nullok=0
debug: pam_yubico.c:957 (parse_cfg): ldap_starttls=0
debug: pam_yubico.c:958 (parse_cfg): ldap_bind_as_user=0
debug: pam_yubico.c:959 (parse_cfg): authfile=(null)
debug: pam_yubico.c:960 (parse_cfg): ldapserver=(null)
debug: pam_yubico.c:961 (parse_cfg): ldap_uri=(null)
debug: pam_yubico.c:962 (parse_cfg): ldap_connection_timeout=0
debug: pam_yubico.c:963 (parse_cfg): ldap_bind_user=(null)
debug: pam_yubico.c:964 (parse_cfg): ldap_bind_password=(null)
debug: pam_yubico.c:965 (parse_cfg): ldap_filter=(null)
debug: pam_yubico.c:966 (parse_cfg): ldap_cacertfile=(null)
debug: pam_yubico.c:967 (parse_cfg): ldapdn=(null)
debug: pam_yubico.c:968 (parse_cfg): ldap_clientcertfile=(null)
debug: pam_yubico.c:969 (parse_cfg): ldap_clientkeyfile=(null)
debug: pam_yubico.c:970 (parse_cfg): user_attr=(null)
debug: pam_yubico.c:971 (parse_cfg): yubi_attr=(null)
debug: pam_yubico.c:972 (parse_cfg): yubi_attr_prefix=(null)
debug: pam_yubico.c:973 (parse_cfg): url=(null)
debug: pam_yubico.c:974 (parse_cfg): urllist=(null)
debug: pam_yubico.c:975 (parse_cfg): capath=(null)
debug: pam_yubico.c:976 (parse_cfg): cainfo=(null)
debug: pam_yubico.c:977 (parse_cfg): proxy=(null)
debug: pam_yubico.c:978 (parse_cfg): token_id_length=12
debug: pam_yubico.c:979 (parse_cfg): mode=client
debug: pam_yubico.c:980 (parse_cfg): chalresp_path=(null)
debug: pam_yubico.c:981 (parse_cfg): mysql_server=(null)
debug: pam_yubico.c:982 (parse_cfg): mysql_port=0
debug: pam_yubico.c:983 (parse_cfg): mysql_user=(null)
debug: pam_yubico.c:984 (parse_cfg): mysql_database=(null)
debug: pam_yubico.c:1020 (pam_sm_authenticate): pam_yubico version: 2.28
debug: pam_yubico.c:1035 (pam_sm_authenticate): get user returned: ido
debug: pam_yubico.c:222 (authorize_user_token): Dropping privileges
debug: util.c:351 (check_user_token): Authorization line: ido:***********
debug: util.c:356 (check_user_token): Matched user: ido
debug: util.c:362 (check_user_token): Authorization token: :***********
debug: util.c:362 (check_user_token): Authorization token: (null)
debug: pam_yubico.c:1157 (pam_sm_authenticate): Tokens found for user
YubiKey for `ido':
debug: pam_yubico.c:1220 (pam_sm_authenticate): conv returned 44 bytes
debug: pam_yubico.c:1234 (pam_sm_authenticate): Skipping first 0 bytes. Length is 44, token_id set to 12 and token OTP always 32.
debug: pam_yubico.c:222 (authorize_user_token): Dropping privileges
debug: util.c:351 (check_user_token): Authorization line: ido::***********
debug: util.c:356 (check_user_token): Matched user: ido
debug: util.c:362 (check_user_token): Authorization token: :***********
debug: util.c:366 (check_user_token): Match user/token as ido/:***********
debug: pam_yubico.c:1276 (pam_sm_authenticate): OTP: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ID: :***********
debug: pam_yubico.c:1277 (pam_sm_authenticate): Token is associated to the user. Validating the OTP...
debug: pam_yubico.c:1279 (pam_sm_authenticate): ykclient return value (0): Success
debug: pam_yubico.c:1280 (pam_sm_authenticate): ykclient URL used: https://api.yubico.com/wsapi/2.0/verify?id=00000&nonce=aaaaaaaayxnvkpqixgkufyhbxnyxztvg&otp=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&timestamp=1
debug: pam_yubico.c:1348 (pam_sm_authenticate): done. [Success]

Done!

Screenshots

(1) Translations + JA glyph rendering in fbterm

License

MIT unless specified otherwise

Owner
Alex Shteinikov
“Beauty is the ultimate defence against complexity”
Alex Shteinikov
Using a GNSS module (Beidou + GPS) and the mapquest static map API

Using a GNSS module (Beidou + GPS) and the mapquest static map API

Kongduino 1 Nov 04, 2021
3D-printable hexagonal mirror array capable of reflecting sunlight into arbitrary patterns

3D-printable hexagonal mirror array capable of reflecting sunlight into arbitrary patterns

Ben Bartlett 2.3k Dec 30, 2022
Implemented robot inverse kinematics.

robot_inverse_kinematics Project setup # put the package in the workspace $ cd ~/catkin_ws/ $ catkin_make $ source devel/setup.bash Description In thi

Jianming Han 2 Dec 08, 2022
ArduinoWaterHeaterIOT - IoT Probe of a solar PV water heating system - Arduino, Python, MQTT, MySQL

ArduinoWaterHeaterIOT IoT Probe of a solar PV water heating system - Arduino, Raspberry Pi, Python, MQTT, MySQL The Arduino sends the AC and DC watts

Jacques Fourie 1 Jan 11, 2022
Component for deep integration LedFx from Home Assistant.

LedFX for Home Assistant Component for deep integration LedFx from Home Assistant. Table of Contents FAQ Install Config Performance FAQ Q. What versio

Dmitry Mamontov 28 Dec 13, 2022
Mini Pupper - Open-Source,ROS Robot Dog Kit

Mini Pupper - Open-Source,ROS Robot Dog Kit

MangDang 747 Dec 28, 2022
LT-OCF: Learnable-Time ODE-based Collaborative Filtering, CIKM'21

LT-OCF: Learnable-Time ODE-based Collaborative Filtering Our proposed LT-OCF Our proposed dual co-evolving ODE Setup Python environment for LT-OCF Ins

Jeongwhan Choi 15 Dec 28, 2022
Python application, displaying currently played track from Spotify on OLED display connected via I2C

RaspberryPi Spotify OLED Display This application will display currently played track on SSD1306 OLED display connected to RaspberryPi. Displayed stuf

Wojciech Olech 2 Dec 30, 2021
Technical Answers to Real-World Problems. Evolution of Watering Manually to Watering Automatically.

Automatic Watering System using Soil Moisture Sensor and RTC Timer with Arduino Technical Answers to Real-World Problems Know the plant, Grow the plan

NelakurthiSudheer 3 Jan 03, 2022
Testing out some (stolen) DMA code for RP2040 Micropython

RP2040_micropython_dma testing out some (stolen) DMA code for RP2040 Micropython. Heavy inspiration and some code from https://iosoft.blog/2021/10/26/

2 Dec 29, 2022
A simple small scale electric car was build which can be driven by remote control and features a fully autonomous parking procedure.

personal-autonomous-parking-car-raspberry A simple electric car model was build using Raspbery pi. The car has remote control and autonomous operation

Kostas Ziovas 2 Jan 26, 2022
Turn your Raspberry Pi Pico into a USB Rubber Ducky

pico-ducky Turn your Raspberry Pi Pico into a USB Rubber Ducky Install Requirements CircuitPython for the Raspberry Pi Pico adafruit-circuitpython-bun

Konstantinos 5 Nov 08, 2022
DIY split-flap display

The goal is to make a low-cost display that's easy to fabricate at home in small/single quantities (e.g. custom materials can be ordered from Ponoko or similar, and other hardware is generally availa

Scott Bezek 2.5k Jan 05, 2023
A PYTHON Library for Controlling Motors using SOLO Motor Controllers with RASPBERRY PI, Linux, windows, and more!

A PYTHON Library for Controlling Motors using SOLO Motor Controllers with RASPBERRY PI, Linux, windows, and more!

SOLO Motor Controllers 3 Apr 29, 2022
DOS-like OS for RP2040 basic microcontroller boards

Micropython DOS-like OS for RP2040 microcontroller boards. Check out the demo video at https://www.youtube.com/watch?v=Az_oiq8GE4Y To start the OS typ

RetiredWizard 58 Dec 27, 2022
Control the lights of Alienware computers under GNU/Linux systems.

Before requesting support please consider that this software is not actively developed. I created it in 2014 for managing my Alienware M14X-R1 (where

rsm 111 Dec 05, 2022
Make your MacOS keyboard brightness fade in and out

Make your MacOS keyboard brightness fade in and out. (It's working depends on the Kbrightness file, which only works for 2015 Macs, so this will only work on 2015 Macs.)

1 Dec 16, 2021
The goal of this project is for anyone with an old printer to be able to double-sided printing.

Welcome to PDF-double-side! Hi! I'm 15. I have a old printer so I can't print double-sided outs. The goal of this project is for anyone with an old pr

DejaVu 4 Dec 28, 2021
This repository contains all the code and files needed to simulate the notspot quadrupedal robot using Gazebo and ROS.

Notspot robot simulation - Python version This repository contains all the files and code needed to simulate the notspot quadrupedal robot using Gazeb

50 Sep 26, 2022
Workshop for student hackathons focused on IoT dev

Scenario: The Mutt Matcher (IoT version) According to the World Health Organization there are more than 200 million stray dogs worldwide. The American

Microsoft 15 Aug 10, 2022