Browse ASCII Files on MiSTer [Feature Request]

Kernel, Main, Utilities & Applications, Miscellaneous Devices.
gus0650
Posts: 14
Joined: Sat Apr 24, 2021 5:33 am
Been thanked: 3 times

Browse ASCII Files on MiSTer [Feature Request]

Unread post by gus0650 »

Hi all, not sure if this is the right place to write this...

I would love to browse simple text files on my Mister, for example game manuals.

This functionality could be very simple -- select a file, scroll with joystick, B button to close. Same look & feel as the Mister menu itself.

I think this feature should be very simple to implement, and would upgrade my Mister experience massively!

Thanks
KremlingKuthroat19
Posts: 237
Joined: Sat Aug 22, 2020 3:08 am
Has thanked: 27 times
Been thanked: 49 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by KremlingKuthroat19 »

I'm with you buddy. My most requested feature is manual support for MiSTer. Being able to look at the original manuals in a PDF viewer would be a godsend for those all NES and Atari 2600 era games where you have no idea what to do. I'm still hoping that a PDF viewer is in the cards someday, but I won't hold my breath on that one. Who knows? It could happen. 6 months ago, people said we've never get save states and that's starting to change.

Viewing the original manuals within the MiSTer menu while playing the game is the last thing holding the MiSTer experience back from being better than software emulation. That and a front end which is a hotly debated issue that I don't want to get into now lol

I'd settle for a simple txt file reader though. That would be an amazing improvement. It'd also be amazing if you could scrape txt files from Gamefaqs. I assume you can still copy, paste, and save them into their own txt files and match them with the corresponding name by making the name of the game and the txt file match (similar to how you get the cheats to work with a specific game). However, that would be a pain in the ass.

You have my vote on this! I think it's a brilliant idea. All that would be needed is for MiSTer to have a 'manuals' folder and use the same folder structure for each core as the 'games' and 'cheats' folders to make sure everything matches correctly.
MrX_Cuci
Posts: 30
Joined: Mon May 25, 2020 7:09 pm

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by MrX_Cuci »

Loads of ASCII manuals for Amiga can be found here: http://www.hipooniosamigasite.org/amigadocs/
KremlingKuthroat19
Posts: 237
Joined: Sat Aug 22, 2020 3:08 am
Has thanked: 27 times
Been thanked: 49 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by KremlingKuthroat19 »

Thanks @MrX_Cuci. I found a great resource for console manuals too: https://www.digitpress.com/library/manuals/

This lists both TXT and PDF manuals for most consoles and handhelds.

Is it realistic to expect a PDF reader for MiSTer without being resource intensive? I know that the De-10 Nano has no proper GUI so does that make implementing an open-source and low-level/low-resource PDF reader unfeasible?
gus0650
Posts: 14
Joined: Sat Apr 24, 2021 5:33 am
Been thanked: 3 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by gus0650 »

Thanks for backing this idea guys!

PDF is maybe asking a bit much. But plain ASCII really shouldnt be a problem.....
netbeui
Posts: 148
Joined: Fri Jul 31, 2020 5:04 am
Has thanked: 77 times
Been thanked: 23 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by netbeui »

I guess this feature request never made it in.. Damn it would’ve been nice to be able to browse simple core specific text files. I realize a help system was added but it doesn’t work for me on a CRT or VGA monitor through the analog IO board :(
AmintaMister
Posts: 277
Joined: Thu Sep 16, 2021 10:54 pm
Has thanked: 720 times
Been thanked: 44 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by AmintaMister »

netbeui wrote: Fri Apr 29, 2022 3:35 am I guess this feature request never made it in.. Damn it would’ve been nice to be able to browse simple core specific text files. I realize a help system was added but it doesn’t work for me on a CRT or VGA monitor through the analog IO board :(
It doesn’t work for me too
akeley
Top Contributor
Posts: 1303
Joined: Mon May 25, 2020 7:54 pm
Has thanked: 416 times
Been thanked: 399 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by akeley »

This feature is already present on MiSTer - it's the Help section. You can browse and display pdfs and .txt files. At the moment by default it only adds per-core .md readmes from the MiSTer wiki, but it's easy to either add your own Manuals directory to the fat/docs/ where they live or populate the per-core ones.

It works for me on a CRT via Direct Video so I'm pretty sure it's possible via I/O too. If you're certain your setup is up to scratch just make a bug report on github about it.

I've been collecting manuals for years and have a ~100GB dedicated folder. The best all-in-one sources are Gamebase packs and the exoDOS collection.
AmintaMister
Posts: 277
Joined: Thu Sep 16, 2021 10:54 pm
Has thanked: 720 times
Been thanked: 44 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by AmintaMister »

akeley wrote: Fri Apr 29, 2022 8:26 am This feature is already present on MiSTer - it's the Help section. You can browse and display pdfs and .txt files. At the moment by default it only adds per-core .md readmes from the MiSTer wiki, but it's easy to either add your own Manuals directory to the fat/docs/ where they live or populate the per-core ones.

It works for me on a CRT via Direct Video so I'm pretty sure it's possible via I/O too. If you're certain your setup is up to scratch just make a bug report on github about it.

I've been collecting manuals for years and have a ~100GB dedicated folder. The best all-in-one sources are Gamebase packs and the exoDOS collection.
Unfortunately via analog board it doesn't work...
ARCADEAGES
Posts: 63
Joined: Sun May 24, 2020 11:58 pm
Location: Toronto
Has thanked: 106 times
Been thanked: 10 times
Contact:

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by ARCADEAGES »

Why not just look it up on your phone or tablet? Then you can have that available while you are playing. Makes for much better experience IMHO.
User avatar
aberu
Core Developer
Posts: 1144
Joined: Tue Jun 09, 2020 8:34 pm
Location: Longmont, CO
Has thanked: 244 times
Been thanked: 388 times
Contact:

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by aberu »

AmintaMister wrote: Fri Apr 29, 2022 10:06 am
akeley wrote: Fri Apr 29, 2022 8:26 am This feature is already present on MiSTer - it's the Help section. You can browse and display pdfs and .txt files. At the moment by default it only adds per-core .md readmes from the MiSTer wiki, but it's easy to either add your own Manuals directory to the fat/docs/ where they live or populate the per-core ones.

It works for me on a CRT via Direct Video so I'm pretty sure it's possible via I/O too. If you're certain your setup is up to scratch just make a bug report on github about it.

I've been collecting manuals for years and have a ~100GB dedicated folder. The best all-in-one sources are Gamebase packs and the exoDOS collection.
Unfortunately via analog board it doesn't work...
Yes, it won't work unless you are viewing the framebuffer on your CRT. Did you regularly read text files on your consumer CRT televisions growing up? I personally didn't. You can make it work by setting custom video_mode's that push super resolutions to the scaler and trick it into doing 15kHz videos, but the results will likely not be great and it's a big hassle.
birdybro~
akeley
Top Contributor
Posts: 1303
Joined: Mon May 25, 2020 7:54 pm
Has thanked: 416 times
Been thanked: 399 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by akeley »

It actually looks very good in text mode and is perfectly readable. Even pdfs look good, though they require zooming in and navigating with cursors, but it's not a big deal. My setup is near my main PC, which is always on, so I view game manuals on that machine, but often look up some core key shortcuts/info via the Help text files on MiSTerr- it's fast and convenient. If somebody is far from a PC then viewing pdf manuals on a CRT is certainly a viable option.

I don't know why it doesn't work via I/O. If it requires cutsom modelines, perhaps this one for the Menu could be used, though not sure under what [tag]?

Couple examples (they look better live):

IMG-20220429-200806.jpg
IMG-20220429-200806.jpg (6.88 MiB) Viewed 1644 times
IMG-20220429-200943.jpg
IMG-20220429-200943.jpg (4.15 MiB) Viewed 1644 times
AmintaMister
Posts: 277
Joined: Thu Sep 16, 2021 10:54 pm
Has thanked: 720 times
Been thanked: 44 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by AmintaMister »

akeley wrote: Fri Apr 29, 2022 6:47 pm
I don't know why it doesn't work via I/O. If it requires cutsom modelines, perhaps this one for the Menu could be used, though not sure under what [tag]?
Thanks, I've tried, unfortunately it doesn't work... I will make a try with DirectVideo...
AmintaMister
Posts: 277
Joined: Thu Sep 16, 2021 10:54 pm
Has thanked: 720 times
Been thanked: 44 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by AmintaMister »

Ok, I've tried with DirectVideo and no luck: when I try to read a text it hangs. Maybe the culprit is the frame buffer of my CRT, a Sony KV21FT1E Trinitron Tv...
akeley
Top Contributor
Posts: 1303
Joined: Mon May 25, 2020 7:54 pm
Has thanked: 416 times
Been thanked: 399 times

Re: Browse ASCII Files on MiSTer [Feature Request]

Unread post by akeley »

@AmintaMister: did you ever get it sorted? I've just tried it from IO board on my KV-21FT1K and it works, same as on all my other consumer sets. Interestingly it doesn't work on a PVM (OEV 203). I get a message to in OSD to either enable the scaler or switch off frame buffer. The latter hangs, as you say. The former (vga_scaler=1) perhaps could work with a modeline, but not sure what [name] in the ini is the help section under (if at all)?
Post Reply