Forum-Scout — A lightweight GTK3/QT desktop app that searches multiple Arch-based Linux forums at once

Hey everyone,

I’ve been working on a small desktop tool called forum-scout — it lets you search multiple Arch-based forums and the Arch Wiki at the same time, from a single window. Results come back sorted by date across all sources, so you can quickly see if your problem has already been discussed somewhere.


Disclaimer: Parts of this tool were built with AI assistance (Claude Sonnet by Anthropic). All code has been reviewed and tested by me.

Available from repo:

Source

Forum Type API
Mabox Discourse Discourse JSON
EndeavourOS Discourse Discourse JSON
Manjaro Discourse Discourse JSON
CachyOS Discourse Discourse JSON
Garuda Discourse Discourse JSON
RebornOS Discourse Discourse JSON
Arch Wiki Wiki MediaWiki JSON
Manjaro Wiki Wiki MediaWiki JSON
Arch BBS BBS DuckDuckGo site-search (off by default)

Features:

  1. Multi-source search — query Discourse forums, Arch Wiki and Arch BBS in one go
  2. Sortable results — click any column header to sort by forum, title or date
  3. Bookmarks — save topics, open or copy links, filter and sort · results marked ★ when already bookmarked · remove directly from the results list
  4. Search history — re-run any previous search with one click
  5. Forums toggle — hide the forum selector with the Forums ▾ button to free up space for results
  6. Dropdown suggestions — live topic suggestions as you type (press Space)
  7. Color-coded forums — consistent colors across Results and Bookmarks tabs
  8. Hover tooltip — full title and URL on mouse-over
  9. Keyboard shortcutsCtrl+L focus search · Escape clear · F5 re-run
  10. Persistent settings — window size, hits per source, active forums and forums bar state saved on exit
  11. Multilingual — 18 languages auto-detected from $LANG: Arabic, Chinese, Danish, Dutch, English, Farsi, French, German, Greek, Hebrew, Japanese, Polish, Portuguese, Romanian, Russian, Spanish, Turkish, Ukrainian

GTK version

Qt version

Disclaimer: Parts of this tool were built with AI assistance (Claude Sonnet by Anthropic). All code has been reviewed and tested by me.

13 Likes

The only suggestion I can think of at the moment is to lighten the text colour in the “Forum” column for the dark theme, as that dark red is quite difficult to read.

Looks like a really interesting and potentially rather useful project. :smiley:

3 Likes

Update:

Thanks for the feedback @BG405.

  • CachyOS color changed to violet to avoid red/orange clash

  • Improve readability on dark themes

1 Like

garuda might be useful

3 Likes

How about multiple search options, ex Forum and then Date

1 Like

Maybe call it forum-scout? There’s already a couple different projects called scout:

aur/scout-bin 0.8.0-1 [+1 ~1.00]
    A safe simple readonly TUI to show file changes including git changes
aur/scout-git 1.0-1 [+1 ~0.00] [out-of-date: 2024-01-25] [orphaned]
    A CLI interface to Tomboy and Gnote

I can add it to the repos if you’d like.

7 Likes

Besides Garuda, adding the manjaro wiki maybe? As a separate tab besides the forum.
Renaming an pushing to repos sounds nice. Or maybe to AUR so that users of other distros also can use it.

1 Like

Cool thanks for all the ideas tips etc. I need some time to digest all of it.

To be continued…

2 Likes

Looking at the source and testing…
Garuda forum is also Discourse, and Manjaro wiki is still a mediawiki so it will literary be a one line change to add them in the “registry”, no new fetchers needed :grinning_face:

Maybe it will be a good idea to take out the translations to a separate file, except English which should be built in. Because in the future there will be more translations and it will bloat the code.

p.s. you are fast…i write this and see you added garuda already…

p.p.s. For some reason the suggestions-history did not appear by me. And the first “bug”: when i search for example for “modulejail” scout returns 4 entries in manjaro forum, but the native discourse(forum) returns those 4+2 more (the memes topic for example). I strongly suspect the bug is by discourse, like it has to periodically reindex something and that is what json serves, but just wanted to say it.

1 Like

Maybe a picture says more… work in progress. I am on the point of adding more translations seeing the manjaro wiki. a seperate file is good idea.

Oh and i renamed it to forum-scout. The name suits even better.

2 Likes

Nope, it isn’t some kind of reindexing. This topic appeared in Scout, but
https://forum.manjaro.org/search?q=modulejail%20order%3Alatest_topic
shows 2 more results at the end. Strange.
(i did git pull && ./install.sh)

p.s. I am an idiot…of course Forum scout resp. the json result is from public source and not logged in and it does not show results from sections not publicly visible like the Member Hub. :facepalm:
Everything works perfectly (didn’t even know there is a RebornOS :slight_smile: )

p.p.s. I also like that it respects the system theme and you did not attempt to hardcode styling, which some developers do and is extremely annoying. I was just a bit worried from the screenshots, they were a bit red for me, but with no reason.

A little unimportant bug - the numbering:


I suggest just remove this hash number column and do not bother fixing it. I think the json reports timestamps according to last post (last occurrence of the search term) in topic, and your sorting is according to topic creation (which is what i would prefer).

Alternatively, if you have the time, rename somehow the hash column (last occurance or something), display the timestamp of the last affected post instead of just the ranking and make it sortable column. That would also mean the star for bookmark will have to go in its own column, because right now it is shown instead of the ranking in the hash column.

Indeed, inspecting it closely: the Garuda news topic, started in 2020, mentions modulejail first time on 18.05.26, a little bit before us, and that is why it is number 1.

Another suggestion: on the tabs row, About tab - the usual stuff, version number when introduced, github link, license etc.

1 Like

Update:

Forum-scout v0.20

Todo: Update previews with latest gui README.

What changed

What’s Changed

Full Changelog: Comparing v0.1.2...v0.2.0 · musqz/forum-scout · GitHub

:penguin:

4 Likes

Ruh-roh, Raggy…

❯ forum-scout
Traceback (most recent call last):
  File "/usr/bin/forum-scout", line 1057, in <module>
    win = ScoutWindow()
  File "/usr/bin/forum-scout", line 300, in __init__
    self._build_ui()
    ~~~~~~~~~~~~~~^^
  File "/usr/bin/forum-scout", line 313, in _build_ui
    root.pack_start(self._build_topbar(),  False, False, 0)
                    ~~~~~~~~~~~~~~~~~~^^
  File "/usr/bin/forum-scout", line 326, in _build_topbar
    self._entry.set_placeholder_text(S["search_ph"])
                                     ~^^^^^^^^^^^^^
KeyError: 'search_ph'
1 Like

This is with fresh config on first boot i guess. Because i have some history now and it does not crash.

1 Like

What’s wrong with using the distributions’ colors the way the developers intended?
For example, EndeavourOS in purple, Manjaro in dark green, CachyOS in turquoise, Mabox in grass green, and so on. As far as possible…

Or maybe even better, using the logos.
(Hmm, what are the legal implications of that?)

1 Like

You are partially right. The problem is those color have to have enough contrast. For example mabox will become the third green nuance… undistinguishable. But EOS can be purple indeed.
In any case, matching the colors exactly and keeping them in contrast will be impossible so a compromise should be made somewhere.

Using the logos in that size on a row of checkboxes - a bad idea. Also for the results. It will just be too small. Trust me, you won’t be able to distinguish mabox from manjaro logo in a size of 12 or even 16 pixels.

Enhancement; GUI; Usability:

Replacing the individual checkboxes with a multiple select dropdown (perhaps between the Search text and the Search button controls) might go some way toward freeing more space for actual Search results.

1 Like

Sounds more like a regression to me. Now i can see whats included with a glance and change with a click.
With a dropdown i will see nothing and require an extra click to change.

1 Like

The default selection could simply be “All Forums” (for example).