Blog

truwrap

A node module for text wrapping into streams that supports 24bit color SGR codes.

Publishing Status

Development Status

Documentation/Help

v4 Breaking change The CLI command has been seperated into it’s own repo truwrap-cli

Many current tty text wrapping solutions have issues with the ‘long’ and currently ‘non-standard’ RGB SGR codes (i.e ^[[38;2;204;51;66m). This meant that, while it’s possible to have wonderful, rich, full gamut colours and the aesthetic data visualisations it entails, it comes at the price of painful typography and corrupted console displays as text is broken up, unnaturally wrapped and becoming unreadable as the SGR codes are dashed against the rocks of 1980’s shortsightedness, confusing your terminal and ever so slightly breaking the heart of design aware coders and administrators everywhere.

Clearly this is unnacceptable!

Previously, the only solution was to take a last, long whistful look at how great console colour could be, before going back to the, at best, 256 colours of the xterm pallette, with it’s lack of useful greens and overly dark purples, or, for some, the even more cruelly devastating 16 colours of the ansi pallette, before heading to the stationary cupboard for a bit of a cry.

But weep no more!

Developed as part of our internal data visualisation system, where having the fidelity of 24 bit colour and embedded images (currently macOS iTerm only) was a huge advantage.

Usage

Installation

npm install --save @thebespokepixel/truwrap

import {truwrap} from '@thebespokepixel/truwrap'

var writer = truwrap({
  left: 2,
  right: 2,
  mode: 'soft',
  outStream: process.stderr
})

var contentWidth = writer.getWidth()

writer.write("Some text to write...", "...and some more.")
writer.write("A new paragraph, if not implicitly present.")
writer.end() // Close the stream

mode can be set to the following values:

soft: words are broken before the column width, giving a left justified appearance.
hard: words are split at the column width.
keep: lines longer than the column width are kept.
container: left and right margins are ignored, giving a full width line.

As outStream was specified, wrapped output is written directly to the stream.

Images

If your terminal suppots them, you can add images into the wrapped output text.

To ensure that images are not used by default you need to set the env var TERM_IMAGES=enabled in your shell. See term-ng for details.

import {truwrap, createImage} from '@thebespokepixel/truwrap'

const image = createImage({
  name: 'test',
  file: join(dirname(fileURLToPath(import.meta.url)), '../media/test.png'),
  width: 'auto', // Number of chars wide you'd like image. 'auto' to take it from the image/set height.
  height: 1,     // Number of lines the image will take
  space: '   '   // A text string that is printed under the image so you can flow the wrapped text around it.
})

var renderer = truwrap({
  mode: 'container'
})

truwrap.write(image.render({
  nobreak: true,  // Don't add a linebreak after the image.
  stretch: false, // If true, distort the image the image to fit the width/height
  align: 1        // How many lines to move back up after printing the image.
  spacing: ' '    // A string to print after realigning the cursor after printing the image.
}))

console.log(truwrap.end())

As no outStream was specified truwrap.end() returns the wrapped text.

Panels

import {truwrap, parsePanel} from '@thebespokepixel/truwrap'

var writer = truwrap({
  left: 2,
  right: 2,
  mode: 'soft',
  outStream: process.stderr
})

const panelSource = parsePanel(
  'One|Two|Three|Four', //Input text with column delimiters
  '|',                  // Column delimiter
  writer.getWidth()     // Total width (chars) to make columns across
)

const panelOptions = {
  maxLineWidth: writer.getWidth(),    // Maximum line width
  showHeaders: false,                 // Show colum headers
  truncate: false,                    // Truncate columns if too wide
  config: panelSource.configuration   // Get config information from parsePanel()
}

writer.panel(panelSource.content, panelOptions)
writer.end() //Close stream

Documentation

Full documentation can be found at https://thebespokepixel.github.io/truwrap/

Frontend Mentor – Space tourism website solution

This is a solution to the Space tourism website challenge on Frontend Mentor. Frontend Mentor challenges help you improve your coding skills by building realistic projects.

Overview

The challenge

Users should be able to:

View the optimal layout for each of the website’s pages depending on their device’s screen size
See hover states for all interactive elements on the page
View each page and be able to toggle between the tabs to see new information

Screenshot

Add a screenshot of your solution.

Note: Delete this note and the paragraphs above when you add your screenshot. If you prefer not to add a screenshot, feel free to remove this entire section.

Links

Solution URL: Add solution URL here
Live Site URL: Add live site URL here

My process

Built with

Vite ReactJS
CSS Modules
React – JS library

What I learned

By building this webapp with reactJS, I learn a lot about single page application and how to build an app by creating every single components and then assemble them. By building a component one by one, it’s very helpful to keep the application easy to understand for beginner developer, and also will make the debugging and maintenance process faster and easier.

Continued development

Use this section to outline areas that you want to continue focusing on in future projects. These could be concepts you’re still not completely comfortable with or techniques you found useful that you want to refine and perfect.

Note: Delete this note and the content within this section and replace with your own plans for continued development.

Useful resources

Vite Official – This helped me for building an app with Vite.

Author

Website – Firmanski
Frontend Mentor – @firmanski
Twitter – @firmanski

Acknowledgments

This is where you can give a hat tip to anyone who helped you out on this project. Perhaps you worked in a team or got some inspiration from someone else’s solution. This is the perfect place to give them some credit.

Note: Delete this note and edit this section’s content as necessary. If you completed this challenge by yourself, feel free to delete this section entirely.

ALPaca

Welcome to the ALP Automated Computed Algorithm (ALPaca)!

ALPaca is an open-source Python library for the phenomenology of Axion-Like Particles (ALPs) with masses in the ranges of $m_a \sim 0.01 – 10,\mathrm{GeV}$, mainly in processes involving mesons.

ALPaca integrates the full analysis with an easy-to-use syntax:

Matching of selected UV-complete models (DFSZ-like, KSVZ-like, flaxions, etc.) to the ALP-EFT.
Numerical running and matching of the ALP-EFT coefficients down to the physical relevant scales, including ALP-$\chi!$ PT.
Calulation of decay rates for processes involving ALPs:
- ALP production in rare meson decays $M_1\to M_2 a$, quarkonia decays $V\to \gamma a$ and non-resonant production $e^+e^- \to \gamma a$,
- ALP decays into photons, leptons and mesons,
- Processes mediated by on-shell ALPs in the Narrow Width Approximation,
- Leptonic and radiative meson decays, and meson mixing, with off-shell ALPs.
Calculation of ALP decay lengths and probability of decaying outside the detector, with a displaced vertex or in the prompt region.
$\chi^2$ statistical analysis, with fine-grained control of the observables and experimental measurements included.
Generation of publication-grade exclusion plots.
Automatic management of the bibliographical references used in the analysis.

The ALPaca team

Jorge Alda: Università degli Studi di Padova & INFN Sezione di Padova & CAPA Zaragoza.
Marta Fuentes Zamoro: Universidad Autónoma de Madrid & IFT Madrid.
Luca Merlo: Universidad Autónoma de Madrid & IFT Madrid.
Xavier Ponce Díaz: University of Basel.
Stefano Rigolin: Università degli Studi di Padova & INFN Sezione di Padova.

ALPaca in action

In this repositoy you can find examples, tutorials and applications of ALPaca.

ALPaca has been used in the following publications:

J. Alda, M. Fuentes Zamoro, L. Merlo, X. Ponce Díaz, S. Rigolin: Comprehensive ALP searches in Meson Decays. arXiv:2507.19578

If you have used ALPaca in your publication and want to be featured in this list, please contact us.

Installation

ALPaca can be installed with pip:

pip3 install alpaca-ALPs

It is strongly recommended to install ALPaca inside a virtual environment (venv), in order to avoid clashes with conflicting versions of the dependencies. In order to create a venv, execute the following command

python3 -m venv pathToVenv

where pathToVenv is the location where the files of the venv will be stored. In order to activate the venv, for Linux or MacOS using bash or zsh

source pathToVenv/bin/activate

For Windows using cmd.exe

C:\> pathToVenv\Scripts\Activate.bat

And for Windows using PowerShell

PS C:\> path_to_venv\Scripts\Activate.ps1

Once the venv is activated, ALPaca can be normally installed and used.

Citing ALPaca

If you use ALPaca, please cite

@article{Alda:2025nsz,
    author = "Alda, Jorge and Fuentes Zamoro, Marta and Merlo, Luca and Ponce D{\'\i}az, Xavier and Rigolin, Stefano",
    title = "{ALPaca: The ALP Automatic Computing Algorithm}",
    eprint = "2508.08354",
    archivePrefix = "arXiv",
    primaryClass = "hep-ph",
    reportNumber = "IFT-UAM/CSIC-25-82",
    month = "8",
    year = "2025"
}

@software{alda_2025_16447036,
  author       = {Alda, Jorge and
                  Fuentes Zamoro, Marta and
                  Merlo, Luca and
                  Rigolin, Stefano and
                  Ponce Díaz, Xavier},
  title        = {ALPaca v1.0},
  month        = jul,
  year         = 2025,
  publisher    = {Zenodo},
  version      = {v1.0.0},
  doi          = {10.5281/zenodo.16447036},
  url          = {https://doi.org/10.5281/zenodo.16447036},
}

Documentation

The ALPaca manual is available on arXiv.

You can also check the automatically-generated documentation.

Feedback

If you encounter bugs or want to propose a new feature, you can contact us using Gihub issues.

Riptide – Netflow v5 generator

Riptide generates Netflow v5 packets for simulated TCP sessions.

Compile and Install

Run the following command to build the tool:

mvn package

Usage

To start, the following command can be used:

java -Dorg.slf4j.simpleLogger.defaultLogLevel=debug \
     -jar target/org.opennms.riptide-1.0-SNAPSHOT-jar-with-dependencies.jar \
     test.yaml \
     1.2.3.4:1234

The following options and arguments are allowed:

FILE
: The file containing the TCP session definition

HOST:PORT
: Host and port of the Netflow receiver – can be specified multiple times

-flush-interval SECS
: The interval used to flush out Netflow packets

-dry-run
: Do not send Packets

-source HOST:PORT
: Spoofs the source address of the Netflow packets

Source address spoofing

To spoof the source address of outgoing Netflow packets, RockSaw must be installed.
After building RockSaw from source, the following Parameter must be added to the java call:

-Djava.library.path=/path/to/resulting/library

In addition, the tool must be run as root user.

TCP Session Definition

The simulated TCP session is described by a yaml file.
See test.yaml for an example.

Gem Warrior (web)

A web version of the Gem Warrior RubyGem.

/-+-+-+ +-+-+-+-+-+-+-\
|G|E|M| |W|A|R|R|I|O|R|
\-+-+-+ +-+-+-+-+-+-+-/

logo courtesy of ascii generator

Gem Warrior is a text adventure that takes place in the land of Jool, where randomized fortune is just as likely as mayhem.

You take up the mantle of [RANDOM NAME HERE], a gifted young acolyte who has been tasked by the queen herself, Ruby, to venture off into the unknown to recapture a Shiny Thing^TM that holds great power within its crystallized boundaries. Unfortunately, it was stolen recently by a crazed madperson named Emerald, bent on using its frightening power for Evil. You are Good, obviously, and the rightful caretaker of such power, but he will not give it up willingly, and has cursed all the creatures of the land into doing his bidding, which is largely tearing you limb from limb.

Start in your poor, super lame cottage, where you live alone, subsisting off the sale of polished rocks you scavenge all day for in the neighboring caves. Once tasked with your quest, travel throughout the land of Jool, eventually reaching the sky tower that Emerald resides in with his stolen goods, laughing to himself, occasionally.

As you travel you will discover sights and sounds of the land, all of which are new to you because you don’t really get out much. Visit towns with merchants willing to trade coin for wares they bought off of other adventurers who didn’t last the previous attempts at thwartion. Sleep in a tent (or on the ground, if that’s all that’s available) to regain your enumerated status points, which are conveniently located in your peripheral vision (i.e. the console window). Eventually, if you’re skilled, you’ll reach Emerald’s Sky Tower, part him from his ShinyThing^tm, and then do what is “right”.

Main Commands

> (c)haracter – character check for weapon/armor/status
> (i)nventory – check your inventory
> (si)t – change status to sitting
> (st)and – change status to standing
> (sl)eep – change status to sleeping

> (l)ook [object] – look at current location and its items and monsters
> (g)et/(p)ickup/(t)ake [object] – take an item from the current location
> (dr)op [object] – drop an item to the current location
> (u)se [object] – use an item from your inventory or current location (use ‘with’ or ‘on’ to combine with other item)

> go [direction] – go in a direction, if possible (north|east|south|west work as shortcuts)

> (h)elp – display available commands
> (hist)ory – display command history
> (a)bout – display information about the creator of GemWarrior
> (ch)ange [attribute] – change some things about yourself or the game

Subsystems

Avatar

Uses a Web Worker to change your avatar (if you so choose to display it) and its characteristics.

Audio

Uses webaudio-tinysynth for making noise.

Favicon

Uses SVGs from icones.netlify.app.

Storage

Uses CacheStorage to save your adventure’s records.

Contributing

Clone repo and get to messing with things. It’s all HTML, CSS, and JS (with some jQuery).

D-Genies

Dot plots are widely used to quickly compare sequence sets. They provide a synthetic similarity overview, highlighting repetitions, breaks and inversions. Different tools have been developed to easily generated genomic alignment dot plots, but they are often limited in the input sequence size. D-GENIES is a standalone and WEB application performing large genome alignments using Minimap2 or MashMap v2.0 software packages and generating interactive dot plots. It enables users to sort query sequences along the reference, zoom in the plot and download several image, alignment or sequence files. D-GENIES is an easy to install open source software package (GPL) developed in Python and JavaScript.

Quick start

This will run dgenies in standalone mode with Linux and OS X. With Windows, please use Linux through WSL

First, install conda (once).
Then, install D-Genies (also once):

conda create -c conda-forge -c bioconda -n dgenies dgenies

Finally, run D-Genies:

conda activate dgenies
dgenies run

D-Genies will open a browser window. It, can be stop by hitting Ctrl + C in terminal

How to use?

You can use the demo instance hosted at genotoul.

Or you can deploy your own instance with the help of the installation documentation.

Documentation

Full documentation, including code API, is available here.

How to cite?

Cabanettes F, Klopp C. (2018) D-GENIES: dot plot large genomes in an interactive, efficient and simple way. PeerJ 6:e4958 https://doi.org/10.7717/peerj.4958

Credits

D-Genies is developed by the Bioinfo team of the Genotoul platform (INRAE).

D-Genies

Dot plots are widely used to quickly compare sequence sets. They provide a synthetic similarity overview, highlighting repetitions, breaks and inversions. Different tools have been developed to easily generated genomic alignment dot plots, but they are often limited in the input sequence size. D-GENIES is a standalone and WEB application performing large genome alignments using Minimap2 or MashMap v2.0 software packages and generating interactive dot plots. It enables users to sort query sequences along the reference, zoom in the plot and download several image, alignment or sequence files. D-GENIES is an easy to install open source software package (GPL) developed in Python and JavaScript.

Quick start

This will run dgenies in standalone mode with Linux and OS X. With Windows, please use Linux through WSL

First, install conda (once).
Then, install D-Genies (also once):

conda create -c conda-forge -c bioconda -n dgenies dgenies

Finally, run D-Genies:

conda activate dgenies
dgenies run

D-Genies will open a browser window. It, can be stop by hitting Ctrl + C in terminal

How to use?

You can use the demo instance hosted at genotoul.

Or you can deploy your own instance with the help of the installation documentation.

Documentation

Full documentation, including code API, is available here.

How to cite?

Cabanettes F, Klopp C. (2018) D-GENIES: dot plot large genomes in an interactive, efficient and simple way. PeerJ 6:e4958 https://doi.org/10.7717/peerj.4958

Credits

D-Genies is developed by the Bioinfo team of the Genotoul platform (INRAE).

HTML5 Single / Multi Radio Player for Website Footers

Description

This HTML5 radio player offers a complete and customizable solution for integrating a sleek and responsive audio player directly into your web pages. With features like an audio visualizer, song history, synchronized lyrics, and social media integration, you can elevate your website’s audio experience.

Key Features:

Audio playback with intuitive controls for play/pause, volume, and station switching.
Dynamic audio visualizer that reacts to the music in real time.
Station list with thumbnails and information.
Song history displaying recently played tracks.
Synchronized lyrics (automatic search via API).
Integrated social sharing for Facebook, Twitter, and WhatsApp.
Links to mobile applications (Android and iOS).
Integration with music information APIs to display real-time track data.

Demo Screenshots

Installation and Configuration

Download the player files:
- Download or clone this repository.
Configure your radio stations:
- Open the config.js file.
- Edit the window.streams.stations variable and replace the example stations with your own.
- For each station, fill in the information: name, hash, description, URLs for logo, album art, background cover, audio stream URL, social links, app links, etc.
- Important: Make sure that the paths for images (logo, album, cover) are correct, considering the location of the config.js file on your website.
Integrate the player into your page:
- Copy the HTML code from the index.html file and paste it into the desired location on your page, usually in the footer.

Advanced Customization

Images: Replace the images in the assets folder with your own.
Colors: Customize the player’s colors by editing the css/custom.css file.
Layout: Modify the player’s layout by editing the player.html file.
Functionality: Adapt the player’s behavior by editing the js/main.js file.

Support and Contributions

If you have any questions or issues, please open an issue in the GitHub repository.
Contributions are welcome! Feel free to submit pull requests with improvements, bug fixes, or new features.

Blog

truwrap

Publishing Status

Development Status

Documentation/Help

Usage

Installation

Images

Panels

Related

Documentation

Frontend Mentor – Space tourism website solution

Table of contents

Overview

The challenge

Screenshot

Links

My process

Built with

What I learned

Continued development

Useful resources

Author

Acknowledgments

ALPaca

The ALPaca team

ALPaca in action

Installation

Citing ALPaca

Documentation

Feedback

Riptide – Netflow v5 generator

Compile and Install

Usage

Source address spoofing

TCP Session Definition

Gem Warrior (web)

Main Commands

Subsystems

Avatar

Audio

Favicon

Storage

Contributing

D-Genies

Quick start

How to use?

Documentation

How to cite?

Credits

D-Genies

Quick start

How to use?

Documentation

How to cite?

Credits

HTML5 Single / Multi Radio Player for Website Footers

Description

Key Features:

Demo Screenshots

Installation and Configuration

Advanced Customization

Support and Contributions