Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Software > Sigil > Plugins

Notices

Reply
 
Thread Tools Search this Thread
Old 09-24-2026, 04:46 PM   #1
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,095
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
[Plugin] SpecialCharacterConfig – GUI editor for Sigil's custom special characters

Updated: October 1, 2026
Current Version: 0.2.4
Status: Beta
Plugin type: edit

Plugin icon:


How it works:
SpecialCharacterConfig is a GUI editor for Sigil's custom special character configuration, which is a new feature introduced in Sigil 2.8.5.

The plugin:
  • creates and edits special character groups;
  • allows Unicode characters to be searched and added;
  • allows characters to be moved between groups;
  • allows characters to be reordered within a group;
  • allows groups to be reordered;
  • allows groups to be hidden from or shown in Sigil's Insert Special Character list;
  • allows character labels and descriptions to be edited;
  • allows character descriptions to be auto-completed from their Unicode name via a right-click context menu;
  • allows the same character to be placed in multiple groups;
  • allows groups to be added, renamed, and deleted;
  • allows Unicode 18.0 blocks to be enabled or disabled;
  • opens existing special_characters.xml files;
  • supports Save and Save As...;
  • creates a backup when overwriting an existing configuration.

The configuration is stored in Sigil's optional special_characters.xml file. Sigil uses this file after it is restarted.

The plugin does not replace Sigil's built-in special character set unless the user deliberately creates and saves a special_characters.xml configuration for Sigil.

This also makes it possible to maintain several different personal character sets and switch between them simply by saving the desired configuration as special_characters.xml.

Installation:
1. Select Manage Plugins from the Plugins menu. In the Manage Plugins dialog box, select Use Bundled Python, if it isn't already selected. (If your Sigil version doesn't have a Use Bundled Python option, click one of the Auto buttons to detect the path or Set to manually select the Python interpreter path.)
2. Click Add Plugin and select SpecialCharacterConfig_v0.X.Y.zip. This will install the SpecialCharacterConfig plugin, which you can then run via Plugins > Edit > SpecialCharacterConfig.

Issues:
This is a beta release. Feedback, bug reports, and suggestions are welcome.

In particular, testing on different operating systems, Unicode ranges, and larger character collections would be useful.

OS Requirements:
Windows, Linux, and macOS should be supported.
Tested on Windows 10 and 11 with Sigil 2.8.5 prerelease. It should also work on Linux and macOS.
*** Linux users will have to make sure that the PySide6 module is present if it's not already. ***

Sigil Requirements:
Minimum version of Sigil: 2.8.5 beta.

Credits/Thanks:
Special thanks to KevinH for implementing support for custom special character groups in Sigil and for his help in defining the XML format used by the plugin.

The plugin itself was developed with the assistance of GPT (vibe coding). It turned out to be a particularly interesting example of using AI-assisted development for a real Qt/Python application.

License/Copying: GNU LGPL Version 2 or Version 3, your choice. Any other license terms are only available directly from the author in writing.
Attached Thumbnails
Click image for larger version

Name:	sigil-isc-sample.png
Views:	72
Size:	8.6 KB
ID:	226202   Click image for larger version

Name:	sigil-scc-020-beta-unicode.png
Views:	61
Size:	64.5 KB
ID:	226328   Click image for larger version

Name:	sigil-scc-024-beta-main.png
Views:	50
Size:	40.2 KB
ID:	226362  
Attached Files
File Type: zip SpecialCharacterConfig_v0.2.4.zip (26.5 KB, 65 views)
File Type: xml default_special_characters.xml (13.3 KB, 4 views)

Last edited by BeckyEbook; Today at 04:48 PM. Reason: Added default set
BeckyEbook is offline   Reply With Quote
Old 09-24-2026, 04:46 PM   #2
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,095
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
Change Log

v0.1.4
- First public beta release.
- GUI editor for Sigil's special_characters.xml configuration file.
- Create, open, edit, and save custom special-character configurations.
- Manage groups and add Unicode characters with a searchable character picker.
- Edit character labels and descriptions.
- Save As support for maintaining multiple personal character sets.
- Automatic .bak backup when overwriting an existing XML file.
- Compatible with Sigil 2.8.5 beta and newer.
- Changes take effect after restarting Sigil.

v0.1.5
- Add Move... to move selected characters between groups.
- Prevent moving a character into a group where it already exists.

v0.1.6
- Add Move Up / Move Down buttons to reorder groups in the Groups list.

v0.1.7
- Add "Move Character Up" / "Move Character Down" buttons to reorder
characters within the selected group. Works with multiple selected rows.

v0.1.8
- Replace the "Move Character Up/Down" text buttons with compact arrow
(Qt::UpArrow / Qt::DownArrow) tool buttons next to Add.../Move.../Remove.
- Fix multi-row selection not being preserved after moving several
characters at once (selectRow() was replacing the selection instead
of extending it).

v0.1.9
- Update the Unicode character browser to the Unicode 18.0 block set,
including newly defined blocks and blocks added since the original list.
- Add Geometric Shapes Extended, including U+1F7EB LARGE BROWN SQUARE.
- Include newly assigned Unicode 17.0 and 18.0 characters even when the
Python runtime uses an older Unicode database, with Unicode-version
fallback names where necessary.
- Add algorithmic fallback names for CJK ideographs, Jurchen, Tangut,
Khitan Small Script, and Small Seal characters.

v0.2.0
- Add a "Unicode Blocks..." dialog to choose which Unicode blocks are
displayed in the Add Special Characters window.
- Allow individual blocks to be enabled or disabled under each main
category; a main category disappears when all of its blocks are disabled.
- Store the Unicode block selection in Sigil plugin preferences.
- Keep all Unicode 18.0 blocks enabled by default.
- Add Select All and Clear All controls to the Unicode Blocks dialog.

v0.2.1
- Add "Hide" / "Show" buttons next to "Move Up" / "Move Down" to toggle
whether a group appears in Sigil's "Insert Special Character" list
(Sigil >= 2.8.5, chargroup hidden="true"). Hidden groups are shown
italicized/greyed out in the Groups list.
- Button enablement follows the selected group's state: "Hide" is
enabled only for a visible group, "Show" only for a hidden one.
- On load, accept hidden="true" (any case) or hidden="1" as hidden;
any other value (missing, "false", "0", garbage...) is treated as
visible and the attribute is dropped on save - matching Sigil's own
SelectCharacter.cpp parsing.

v0.2.2
- Replace the separate "Hide" / "Show" buttons with a single toggle
button next to "Move Up" / "Move Down" that reads "Hide" for a
visible group and "Show" for a hidden one.

v0.2.3
- Additional spacing before the Show/Hide button

v0.2.4
- Add a "Complete the Description" context-menu action on the
character table (works on one or several selected rows): fills in
the Description column from the character's Unicode name (or the
same fallback names used by the Unicode character browser) for any
selected character that doesn't already have one. Existing
descriptions are left untouched.

Last edited by BeckyEbook; 10-01-2026 at 06:04 PM. Reason: Update
BeckyEbook is offline   Reply With Quote
Advert
Old 09-24-2026, 08:19 PM   #3
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 55,914
Karma: 182837452
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Sage, Libra Colour, Lenovo M8 FHD, Paperwhite 4, Tolino epos
I moved the ¥ sign to currency, added a few more currency symbols, some bits and bobs from my old saved symbols. Saved, restarted Sigil and looked good.

Only issue is that I could not find a way to move an item so ended up deleting the ¥ sign and recreating it.
DNSB is offline   Reply With Quote
Old 09-25-2026, 03:34 AM   #4
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,095
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
Thank you for the feedback, @DNSB. You're right – this makes moving characters between groups much easier.

Added in v0.1.5.
BeckyEbook is offline   Reply With Quote
Old 09-25-2026, 04:07 AM   #5
DNSB
Bibliophagist
DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.DNSB ought to be getting tired of karma fortunes by now.
 
DNSB's Avatar
 
Posts: 55,914
Karma: 182837452
Join Date: Jul 2010
Location: Vancouver
Device: Kobo Sage, Libra Colour, Lenovo M8 FHD, Paperwhite 4, Tolino epos
I tried adding the angle quotation marks («, », ‹ & ›) plus moving the narrow non-breaking space to the punctuation block and no issues.
DNSB is offline   Reply With Quote
Advert
Old 11-06-2026, 12:44 AM   #6
byword
Enthusiast
byword began at the beginning.
 
Posts: 38
Karma: 10
Join Date: Apr 2022
Device: Onyx Leaf 3
Thank you for the great work. This feature was implemented exactly the way I needed it. I tested it immediately after the Sigil update, and it works perfectly.

**
I posted this thinking I found an issue, but it turns out there was already a solution. If you read my message before I edited it, please ignore it.
Attached Thumbnails
Click image for larger version

Name:	스크린샷 2026-11-06 105018.png
Views:	37
Size:	33.2 KB
ID:	227214   Click image for larger version

Name:	스크린샷 2026-11-06 104947.png
Views:	33
Size:	72.6 KB
ID:	227215  

Last edited by byword; 11-06-2026 at 12:54 AM.
byword is offline   Reply With Quote
Old 11-10-2026, 09:43 AM   #7
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 10,245
Karma: 7640672
Join Date: Nov 2009
Device: many
I added this to the Sigil Plugin Index now since Sigil >= 2.8.5 has been released! Thank you!
KevinH is offline   Reply With Quote
Old Yesterday, 03:01 PM   #8
Mister L
Groupie
Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.
 
Posts: 188
Karma: 91148
Join Date: Jun 2010
Device: Sony 350
Thanks for this plugin, I think it will be very useful. But I think I am doing something wrong when I try to configure it. I would like to start from the existing list of characters, and add some new ones. But when I start the plugin, the list is empty, and if I save and restart Sigil, the character window is empty too. If I create a new list and add something, it overwrites the original list and I have only the symbols I added. How can I get the original list of characters to modify?
Mister L is offline   Reply With Quote
Old Yesterday, 04:23 PM   #9
KevinH
Sigil Developer
KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.KevinH ought to be getting tired of karma fortunes by now.
 
Posts: 10,245
Karma: 7640672
Join Date: Nov 2009
Device: many
You would have to manually create one unless someone here has already done that and can share it with you.

FWIW, There is nothing special about the original list except they were primarily the same characters as those chosen for named entities in early html and epub2 xhtml.

If no one else has one to share, I can certainly take a shot at creating one.
KevinH is offline   Reply With Quote
Old Yesterday, 04:56 PM   #10
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,095
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
That's not a problem; I have a file like that because I used it as a template for testing.
In the next version of the plugin, there will be an option to use the default layout. That might actually be a good idea, so as not to present the user with a "blank page."
BeckyEbook is offline   Reply With Quote
Old Today, 02:32 PM   #11
Mister L
Groupie
Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.Mister L is the 'tall, dark, handsome stranger' all the fortune-tellers are referring to.
 
Posts: 188
Karma: 91148
Join Date: Jun 2010
Device: Sony 350
Quote:
Originally Posted by KevinH View Post
You would have to manually create one unless someone here has already done that and can share it with you.

FWIW, There is nothing special about the original list except they were primarily the same characters as those chosen for named entities in early html and epub2 xhtml.

If no one else has one to share, I can certainly take a shot at creating one.
Quote:
Originally Posted by BeckyEbook View Post
That's not a problem; I have a file like that because I used it as a template for testing.
In the next version of the plugin, there will be an option to use the default layout. That might actually be a good idea, so as not to present the user with a "blank page."
Oooooh ok, I understand. I thought I broke something.
BeckyEbook if you have a file already I would love to have it, but otherwise I can just wait for the next version, it's not urgent! Or if I need something sooner I will just take a screenshot of the original list for reference.

Mister L is offline   Reply With Quote
Old Today, 04:51 PM   #12
BeckyEbook
Wizard
BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.BeckyEbook ought to be getting tired of karma fortunes by now.
 
BeckyEbook's Avatar
 
Posts: 1,095
Karma: 4000789
Join Date: Jan 2017
Location: Poland
Device: Various
I added a file with the default character set to my first post.
Just open it in the plugin, and it will be recognized as the default.
This allows you to have several different sets for various needs.
It’s certainly overkill, but for some power user who processes hundreds of files in different languages and fields… who knows?
BeckyEbook is offline   Reply With Quote
Reply


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[GUI Plugin] Goodreads Characters and Settings VapidRapidReader Plugins 16 Today 05:08 PM
[Plugin] EnvVarEditor - GUI editor for Sigil's environment variables BeckyEbook Plugins 51 09-17-2026 10:15 AM
Editor plugin : problem with regex and special characters EbookMakers Development 4 11-14-2019 08:52 AM
Missing Characters in Editor-GUI Divingduck Editor 3 02-20-2014 02:31 AM
Special Characters in Sigil paulhypno Sigil 3 11-18-2012 09:46 AM


All times are GMT -4. The time now is 10:27 PM.


MobileRead.com is a privately owned, operated and funded community.