Author Topic: BBCeditor (forum post edit tool)  (Read 909 times)


  • Hero Member
  • *****
  • Posts: 6695
This one is for forum members that create more lengthy and/or complicated formatted posts.

Everything in this thread has been a result of the joint effort between fellow forum member karbock and me.


Constructing a formatted post that includes tables, lists, colouring, etc. is usually a lot of work.
Posts like these:

Regular Expressions: coding, examples, testing resources

MusicBee functions for virtual tags cheatsheet

take a lot of time to construct and maintain.

The necessity to go and be online on the forum to check the result of each and every edit is not ideal.
Using this tool takes away the need to go online. You can create, edit and check your post locally, offline before you publish anything.

The tool is called BBCeditor, and I wish I had discovered it some ten years ago.
Ah well, thanks to fellow forum member karbock at least now I have.

The tool hasn't had active maintenance for a couple of years now, and there doesn't seem to be a dedicated website for it, but it shouldn't be hard to find a download for it. The latest version seems to be 1.1.35. (or 1.1.35b, but those seem to be same)

In the left panel you can write and design the post making use of all the usual BBcodes, and in the right panel you can get a preview of how it will look like on the forum.

like this:

Another benefit of this tool is that it makes it easy to store any work-in-progress postings.
Just save them within the tool (they are saved as .bcc files), and open, edit and then post them at any later time.

Note that out-of-the-box, the preview pane on the right does not resemble the MusicBee forum very much.
See below for more information on that.



As karbock and I found out, out-of-the-box BBCeditor is not completely compatible with the way how the MusicBee forum handles BBcode
It can be made so that it does, but that takes a lot of tweaking.
(as the following posts describe)

So we looked for a way to make this all a lot simpler for other forum members.
And we came up with a simple solution that seems to work very well:
We created some files and folders that contain all that is necessary to update BBCe so that its buttons and functions are fully compatible with our forum.
All that is needed is:

- download BBCeditor v1.1.35
- install it wherever you want (it's a portable application)
- download the BBCeditor MusicBee patch here
- extract the rar file
- copy all its files and folders to where you installed BBCeditor (overwriting the existing ones)

that's all

Here's an impression of some things that can be done:

The download also contains  a template forum post (a .bbc file) that has examples of some BBcode markup options such as tables, font colouring, lists with bullet points, etc.  (use 'File > Open' to open it)

Last Edit: March 21, 2023, 04:58:13 PM by hiccup


  • Hero Member
  • *****
  • Posts: 6695

Pretty much everything this post contains doesn't have to be performed manually anymore, since the downloadable patch version that karbock and I have constructed and made available for download (see post #1) now contains pretty much all these features by default.

I'll leave it here anyway, since it's probably informative to those who want to extend this button functionality themselves.


How to create buttons for forum-safe font colours and useful font sizes.

BBCe has dropdown buttons for both font colours and font sizes.
Do not use them:
- The font size presets create code that will not work on the forum.
- The font colour presets contain colours that will be practically unreadable, depending on if a user uses the light or the dark forum theme.

Luckily BBCe has the option to create custom buttons for specific tasks.

Here are the steps to create buttons for forum-safe colours, and for useful font sizes.


Buttons to set forum-safe font colours

create 16x16px. icons for these buttons.
(or use the ones that are included in the download link that's in the startpost)

place them in the folder: custom_icons

Navigate to: Tools > Settings > Custom buttons

Create a new button using these settings:

and link the appropriate icon for it using 'Path:'

Create buttons for the other eight colours using:


You then should have something like this:


Buttons to set useful font sizes

As said before, the font sizes that BBCe's default presets button sets are useless for our forum.

This is how to create 4 useful font size buttons that will work nicely on our forum: small, medium, large and extra-large.
(the default font size will sit between small and medium)

The steps to perform are identical to the ones used for the font colours.
Only now the 'Expression' pane needs to be populated with these four expressions:


This is a selection of font sizes I think are useful for our forum.

But... due to discrepencies between BBcode engines, they will not look correct in BBCe's preview panel.
E.g. when using the forum's "size=1", it will display in a 1px size in the preview pane, making it unreadable.

Therefor an additional 4 buttons need to be created that will adjust the sizes for the preview panel so that they will display there in the same size as they will show up on the forum.
These buttons do not need to be pressed, and will work automatically in the background at every screen refresh (F5).
So there is also no need to create icons for them.

This time also the 'Replacement' pane needs to be populated.

These are the codes:

Expression:     font-size:1px
Replacement:   font-size:9px

Expression:     font-size:medium
Replacement:   font-size:16px

Expression:     font-size:x-large
Replacement:   font-size:24px

Expression:     font-size:6px
Replacement:   font-size:34px

That's it.

You should now have these buttons, and these font sizes available:



For those who want to experiment or make tweaks, these are the values I found when testing things, and what I used for the above instructions:

  single digit code  
   use replacement:    
font-size 1font-size:9px
font-size 2useless: identical to default size        
font-size 3font-size:19px
font-size 4font-size:20px
font-size 5font-size:26px
font-size 6font-size:34px
font-size 7font-size:51px

      named code      
pixel size on forum
size=small13  (useless, identical to default size)
Last Edit: March 21, 2023, 07:04:27 PM by hiccup


  • Hero Member
  • *****
  • Posts: 6695
I have a question myself about a feature of BBCeditor:
It is possible to create 'buttons' that can modify content in the left panel...
But there is one thing I don't understand and can't get to work...

never mind, pretty much solved
Last Edit: March 01, 2023, 06:08:39 PM by hiccup


  • Full Member
  • ***
  • Posts: 157
Forum-friendly colour sets

As mentioned above by hiccup, the forum post editor proposes 9 predefined custom colours.
Another set is also shown here, with the advantage of featuring colours having predefined names in BBcode.

You can see below what the two sets look like with both forum themes (dark and light).
N.B.: 'gray' instead of 'grey' in the tables, to be consistent with BBcode's colour names in US spelling.

Preview (clickable images)

Colour set of the forumColour set with predefined colour names

9-colour set of the forum post editor

Colourise your text by using their matching hexadecimal code only, since they have no predefined colour name in BBcode.

Colour typeHex. codeBBcode colour name
██ bluecolor=#0093F8
██ browncolor=#9E6F00
██ cyancolor=#40C2B9
██ graycolor=#8F8F8F
██ greencolor=#00A300
██ khakicolor=#BFAD00
██ orangecolor=#EE8200
██ redcolor=#FC0003
██ violetcolor=#CD78D6

9-colour set featuring named colours

Colourise your text by using:
  • either the matching hexadecimal code
  • or the BBcode colour name

Colour typeHex. codeBBcode colour name
██ bluecolor=#6495EDcolor=CornFlowerBlue
██ browncolor=#D2691Ecolor=Chocolate
██ cyancolor=#20B2AAcolor=LightSeaGreen
██ graycolor=#778899color=LightSlateGray
██ greencolor=#32CD32color=LimeGreen
██ khakicolor=#B8860Bcolor=DarkGoldenRod
██ orangecolor=#FF8C00color=DarkOrange
██ redcolor=#FF6347color=Tomato
██ violetcolor=#BA55D3color=MediumOrchid

A full list of the 141 predefined colours + transparent is available here  (with explanations).
Last Edit: February 27, 2023, 01:22:31 PM by karbock


  • Hero Member
  • *****
  • Posts: 6695
Below, a selection of named colours suitable for both forum themes (dark and light).
Nice selection.
I have added a 'forum-safe' template to the download.
It will make it easy to preview the colours and copy/paste the hex codes.

Last Edit: February 20, 2023, 06:36:22 PM by hiccup


  • Full Member
  • ***
  • Posts: 157
BBcode for the Forum Post Editor

BBcode is the formatting language used by many forums on the internet, but it is not completely standardised.
This post presents the subset used by the MusicBee forum editor.

Table of contents
  • Character styles
  • Internet links
  • Paragraphs
  • Code
  • Quote
  • Tables
  • Lists
  • BBcode markers not supported by the forum editor
  • BBCeditor markers not supported by the forum editor

Character styles

Bold[b]...[/b]Regular / [b]Bold[/b]Regular / Bold
Italic[i]...[/i]Regular / [i]Italic[/i]Regular / Italic
Underline[u]...[/u]Regular / [u]Underline[/u]Regular / Underline
Monospace[tt]...[/tt]Regular / [tt]Monospace[/tt] Regular / Monospace
Strikethrough[s]...[/s]Regular / [s]Strikethrough[/s]Regular / Strikethrough
Superscript[sup]...[/sup]Regular / [sup]Superscript[/sup]Regular / Superscript
Subscript[sub]...[/sub]Regular / [sub]Subscript[/sub]Regular / Subscript
Size (with name)[size=...]...[/size]Regular / [size=xx-small]xx-small[/size]
Regular / [size=x-small]x-small[/size]
Regular / [size=small]small[/size]
Regular / [size=medium]medium[/size]
Regular / [size=large]large[/size]
Regular / [size=x-large]x-large[/size]
Regular / [size=xx-large]xx-large[/size]
Regular / xx-small
Regular / x-small
Regular / small
Regular / medium
Regular / large
Regular / x-large
Regular / xx-large
Size (with number)*[size=...]...[/size]Regular / [size=1]size=1[/size]
Regular / [size=2]size=2[/size]
Regular / [size=3]size=3[/size]
Regular / [size=4]size=4[/size]
Regular / [size=5]size=5[/size]
Regular / [size=6]size=6[/size]
Regular / [size=7]size=7[/size]
Regular / size=1
Regular / size=2
Regular / size=3
Regular / size=4
Regular / size=5
Regular / size=6
Regular / size=7
Colour (with hexa code)*[color=#hexa6]...[/color]Regular / [color=#FF8C00]Text in DarkOrange[/color]Regular / Text in DarkOrange
Colour (with name)*[color=ColourName]...[/color]Regular / [color=DarkOrange]Text in DarkOrange[/color]Regular / Text in DarkOrange

  • Sizes with numbers (1..7) are possible in BBCeditor with the patch (see 1st post of the thread).
  • Forum-friendly colour sets are proposed here.

Internet links

Weblink (named)[url=...]...[/url][url=]
MusicBee Forum

MusicBee Forum

Image (clickable)[url=...]
Image (resized)*[img width=...]
[img width=30][/img]
[img height=...]
[img height=50][/img]
[img width=... height=...]
[img width=30 height=50][/img]

  • The syntax for image resizing on the forum is not natively supported by BBCeditor, but you can encode it. See this post.


Line break*[br]Line 1[br]Line 2Line 1
Line 2
Scrolling text[move]...[/move][move]Don't forget![/move]Don't forget!
Unparsed BBcode[nobbc]...[/nobbc]This post uses [nobbc]...[/nobbc] for each example.
Preformatted text*[pre]...[/pre][pre]What's up, [b]Doc[/b]?[/pre]
[pre][color=Blue]What's up, [b]Doc[/b]?[/color][/pre]
What's up, Doc?

What's up, Doc?
Info bubbles*[abbr="..."]...[/abbr]file extension: [abbr="Free Lossless Audio Codec"].flac[/abbr]file extension: .flac
[acronym="..."]...[/acronym]file extension: [acronym="MPEG-4 audio file"].m4a[/acronym]file extension: .m4a

  • Marker nobbc is ignored by BBCeditor, thus simply displayed as it is. No solution found yet.
  • Markers br, pre, abbr and acronym are not natively supported by BBCeditor, but you can encode them. See this post.
  • Preformatted text = monospace + stand-out background. Not suitable for the dark forum theme, unless you specify a colour such as 'Blue'.


$title = "${movement_no}. ${movement_name}";

will produce:

$title = "${movement_no}. ${movement_name}";


Without custom title

Inspiration does exist, but it must find you working. (Pablo Picasso)

will produce:
Inspiration does exist, but it must find you working. (Pablo Picasso)

With author's name

[quote=Eleanor Roosevelt]
When you give joy to other people, you get more joy in return. You should give a good thought to happiness that you can give out.

will produce:
Quote from: Eleanor Roosevelt
When you give joy to other people, you get more joy in return. You should give a good thought to happiness that you can give out.

With author's name, link and timestamp

[quote author=hiccup link=topic=38856.0 date=1676791981]
Another benefit of this tool is that it makes it easy to store any work-in-progress postings.

will produce:
Another benefit of this tool is that it makes it easy to store any work-in-progress postings.


Table, row and cell markers

[table]...[/table] encloses the table definition
[tr]...[/tr] encloses each table row
[td]...[/td] encloses each cell of a table row


will produce:


  • th (table header) is not supported by the forum editor.
  • code and quote inserts in table cells are not supported by the forum editor.
  • Nested tables (a table within a table cell) are parsed correctly by the forum editor, but misinterpreted by BBCeditor.


  • Markers *, o and x are easier to use.
    They do not require a closing marker, but they must start a line.
  • Use item markers li and /li if you want to include line breaks into your list items.
  • Except for a Default list, do not use the list button of BBCeditor, since the special list markers of that application are not recognised by the forum editor. Instead, create in BBCeditor your own snippets (or custom buttons) using the markers described below.

Lists with single item markers (* o x)

Bulleted list: disc*[list]
List 1:[list]
[*] first item
[*] second item
List 1:
  • first item
  • second item
Bulleted list: circle*[list]
[o] or [O]
List 1:[list]
[o] first item
[o] second item
List 1:
  • first item
  • second item
Bulleted list: square*[list]
[x] or [+] or [#]
List 1:[list]
[x] first item
[x] second item
List 1:
  • first item
  • second item
Nested lists*[list]
Nested lists:
[*] 1
[*] 2
[*] 3
[o] 3.1
[o] 3.2
[*] 4
[o] 4.1
[x] 4.1.1
[*] 5
Nested lists:
  • 1
  • 2
  • 3
    • 3.1
    • 3.2
  • 4
    • 4.1
      • 4.1.1
  • 5

Lists with double item markers (li ... /li)

  • Each list definition specifying the type (list type=...) requires double item markers: li and /li. See the first table row for a model.

Bulleted list[list]
[li]item 1[/li]
[li]item 2[/li]
Bulleted list: disc*[list type=disc]
Bulleted list: circle*[list type=circle]
Bulleted list: square*[list type=square]
Alphabetic list*[list type=lower-alpha]
[list type=upper-alpha]
Numbered list*[list type=decimal]
Roman numerals*[list type=lower-roman]
[list type=upper-roman]
Non-bulleted list*[list type=none]

  • Special bullet types (circle, square) and special list types (alphabetic, decimal, roman) are not natively supported BBCeditor, but you can encode them. See this post.
  • Do not mix codes * and li.../li in the same list: they are treated as items of the same level by BBCeditor, whereas they will show as nested lists on the forum.
  • A list definition enclosed in color.../color markers is misinterpreted by the forum editor.
  • When defining nested lists, it is best to use different bullet markers (*, o, +) to differentiate them in your BBcode script.
  • The forum editor does not recognise nested lists using li.../li.

BBcode markers not supported by the forum editor

Non-exhaustive list. Only the most frequent ones in other BBcode variants:
  • th: table header
  • h1, h2, h3, ...: text header levels
  • hr: horizontal line
  • spoiler: button to reveal hidden text
  • shadow: character style
  • glow: character style
BBCeditor markers not supported by the forum editor

The following list features are defined by other markers in the forum editor. See also this post.
  • list=1: list, numbered
  • list=a: list, alphabetic, lowercase
  • list type=z: list, alphabetic, lowercase
  • list type=A: list, alphabetic, uppercase
  • list type=I: list, roman numbers, uppercase
  • list type=i: list, roman numbers, lowercase
Last Edit: March 28, 2023, 01:13:37 PM by karbock


  • Hero Member
  • *****
  • Posts: 6695
The .css styles were updated.
Also I have found a solution for the discrepancy between BBCeditor's and the forum's font size handling.
See post #2


  • Full Member
  • ***
  • Posts: 157
The .css styles were updated.
Also I have found a solution for the discrepancy between BBCeditor's and the forum's font size handling.
See post #2
Hat tip!


  • Hero Member
  • *****
  • Posts: 6695
Hat tip!
The solution now looks rather simple, but I had headaches first trying out all sorts of BBCode > HTML, and regex stuff that sometimes completely failed, sometimes seemed to work, but only under some circumstances, or even fatally crashed BBCe.

It's really a pity there is no help file, nor a tutorial on how this expression/replacement button stuff is supposed to work exactly.
I couldn't even figure out the purpose, workings and differences between Command > Single tag (i.e. hr) and Double tag (i.e. code).
These smart coders should really make an effort sometimes to place themselves in the minds of mortal end-users...

In case other users dare to explore this expression/replacement functionality, perhaps it is of some use for me to share why (I think)  many of my earlier attempts failed.
I started with entering complete HTML replacement strings into the replacement panel.
Such as e.g.: <span style="font-size:4px;"> </span><span style="font-size:20px;">$1</span>
(and dozens of variations on that :-(
But for the purpose of these particular buttons, no HTML code seems to be needed at all.
It seems to only replace parts within the HTML code that the preview panel is already using.
I'm quite a bit out of my depth here, but maybe this provides some insight to others attempting to use this functionality.
And then come up with some other useful button ideas?...
Last Edit: February 26, 2023, 06:48:08 PM by hiccup


  • Hero Member
  • *****
  • Posts: 6695
  • post #2 was changed into a comprehensive 'HowTo' create custom buttons to set font colours and font sizes
  • icons that can be used for custom buttons for font sizes and colours were added to the download
  • both the light and dark MusicBee forum styles were updated (thanks karbock)


  • Full Member
  • ***
  • Posts: 157
Implementing forum-specific markers in BBCeditor

Some forum markers are not natively supported by BBCeditor (or their syntax differs),
but you can 'teach' BBCeditor to recognise them.

  • Start BBCeditor
  • Menu Tools /Settings, tab Custom buttons
  • For each row of the table below that you wish to incorporate into BBCeditor:
    • Click on button +
    • Select Regular expression
    • For Expression:, copy/paste the matching cell content
    • For Replacement:, copy/paste the matching cell content
  • Validate with OK.
This was made possible thanks to hiccup's insight into the replacement feature of BBCeditor.

Forum editor markerBBCeditor native equivalentExpression:Replacement:
[abbr="..."]...[/abbr]N/A\[abbr="(.*?)"](.*?)\[/abbr]<abbr title="$1">$2</abbr>
[acronym="..."]...[/acronym]N/A\[acronym="(.*?)"](.*?)\[/acronym]<acronym title="$1">$2</acronym>
[o] or [O]N/A\[[oO]](.*?)<li type="circle">$1</li>
[x] or [+] or [#]N/A\[[x+#]](.*?)<li type="square">$1</li>
[list type=disc]N/A\[list type=disc]<ul style="list-style-type:disc;">
[list type=circle]N/A\[list type=circle]<ul style="list-style-type:circle;">
[list type=square]N/A\[list type=square]<ul style="list-style-type:square;">
[list type=decimal][list=1]
[list style=1]
\[list type=decimal]<ul class="list-decimal">
[list type=lower-alpha][list=a]
[list type=z]
\[list type=lower-alpha]<ul class="list-lower-alpha">
[list type=upper-alpha][list type=A]\[list type=upper-alpha]<ul class="list-upper-alpha">
[list type=lower-roman][list type=i]\[list type=lower-roman]<ul class="list-lower-roman">
[list type=upper-roman][list type=I]\[list type=upper-roman]<ul class="list-upper-roman">
[list type=none]N/A\[list type=none]<ul style="list-style-type:none;">
[img width=...] or
[img height=...]
\[img (width|height)=([0-9]*)](.*?)\[/img]<img class="image" src="$3" $1="$2">
[img width=... height=...][img=...x...]\[img (width|height)=([0-9]*) (width|height)=([0-9]*)](.*?)\[/img]<img class="image" src="$5" $1="$2" $3="$4">
[font=...][/font]N/A\[font=(.*?)](.*?)\[/font]<font face="$1">$2</font>
Last Edit: March 17, 2023, 06:59:33 PM by karbock


  • Hero Member
  • *****
  • Posts: 6695

The download now contains a complete 'make BBCe MusicBee forum compatible' patch.

See the start post for all information.