DIY your own FSM (6 Viewers)

This site may earn a commission from merchant affiliate
links, including eBay, Amazon, Skimlinks, and others.

Joined
Jan 17, 2016
Threads
62
Messages
7,381
Location
Chicago, IL, USA
[Note: I have an FSM update forthcoming which will cover all the way through the 2021 model year. A few others on the forum are downloading and testing to help me make sure it works as expected and isn't missing any docs. For those just looking for the FSM .ISO file, I hope to publish info on that perhaps as early as this weekend. Watch the "FSM for 200 series" thread for updates. This post is not about that release, and if you ask for a link to the FSM download here I'm going to make fun of you and then promptly ignore the request]

Over the years of building a downloadable FSM, adding 40, 60, 80, and 100-series docs as well as non-US info upon request, I've built up a fairly large collection of scripts that I'd use to mirror them. As those of you have talked with me about the FSM know, the TIS site uses all sorts of javascript code to assemble and generate the website, so it's not just as simple as using a basic website downloader/spider tool. So as part of my most recent effort I decided to clean up, debug and fix, and then publish all the tools I've written and make them freely available for anyone who wants to use them.

Why would you do this? (And why would I use these?)

A few reasons:
  1. Over the years I've had various people request FSMs for different vehicles (GX460, 4Runner, Supra, etc). I don't have the time (or desire) to create these, but if they're important to you that doesn't mean you shouldn't be able to
  2. I've done this a few times now, and given the 200-series is done production I feel like this is a great time for me to call the existing LC/LX FSM complete. Which is a fancy way of saying "I'm done maintaining/updating this". When the LX600 (300-series) comes out, I'm probably not going to update the existing FSM (unless I end up with one down the road), but that doesn't mean someone else can't take the baton.
  3. My FSM is huge, about 46GB now. If you only have one or two vehicles you could likely shrink that down to 1 or 2GB. Using these scripts you can customize what you want to build into your FSM
  4. Providing the FSM has been an ethical dilemma for me. I wish Toyota would just outright sell a downloadable or printable copy. I've done it up until now because many of us home mechanics were trying to troubleshoot problems or do our own wrenching and needed the data, and the TIS website is not always convenient. But it's also meant people were getting the data for free. So with these tools if you want an FSM for your model, you can purchase a $20 TIS 2-day subscription and then use the scripts to archive your own copy.
A particular note about #4 above: I'm not a lawyer, and the TIS subscription probably says something like "you agree not to harvest copies of the documents" or something like that. There's a large camp of people that will argue for fair use, your ability to work on your own vehicle, etc. I believe if everyone pays the $20 only downloads the data for their vehicle and model year for personal use then any click-through agreement is probably unenforceable, practically if not legally.

What does the FSM include?

Using the tools will allow you to mirror the TIS site and will download the Repair Manual, Electrical Wiring Diagrams, Body Repair/Collision Repair Manual, New Car Features. It will also create searchable and printable PDF files for each section of each manual. (Note however that some of the manuals can be upwards of 10,000 pages, so it's probably impractical to print the whole thing - however you can save the PDFs to your tablet or phone and search them if you break down on a trail or somewhere in which you don't have internet access).

So how do I DIY my own FSM?

This is the more technical part of the post.
  • I've tested the tools on Ubuntu Linux 20.04. They should work on pretty much any recent Linux version with little to no changes. They may work on MacOS X as well as on Windows with the right software installed (Cygwin, for example), however I haven't tried. If someone wants to send me a Macbook I'm more than happy to make them work. (I'm not going to attempt Windows, but feel free to discuss it in this thread). If you want to set up a Linux server for this, I recommend installing VMware Fusion on your desktop, or spend a few $ and create a virtual machine running Linux in AWS, Google Cloud, Azure, etc.
  • You'll need to be comfortable working in a command line. There are a bunch of scripts you need to run and I'm not even going to attempt to make some sort of GUI tool to use them.
  • There are a few tools you'll need to make sure are installed on your system (Ghostscript, wkhtmltopdf, wget, and Perl in particular)
The full list of requirements is at GitHub - rootflags/tis-clone: Download a copy of the Toyota/Lexus/Scion electronic factory service manual - https://github.com/rootflags/tis-clone

Information on how to set up your environment (directories and configuration file) is at tis-clone/HOWTO.md at main · rootflags/tis-clone - https://github.com/rootflags/tis-clone/blob/main/HOWTO.md

Once you have your Linux (or whatever) image set up, you can download the latest release from:


Or if you're feeling brave, you can download the latest version of the code directly by running 'git clone GitHub - rootflags/tis-clone: Download a copy of the Toyota/Lexus/Scion electronic factory service manual - https://github.com/rootflags/tis-clone.git'. That is guaranteed to get you all the latest bug fixes, as well as all the latest newly introduced bugs :-)

The rest of the steps are covered in the HOWTO file linked above, but for posterity the steps are basically:
  • Once you've downloaded the code, move the folder to /tis-clone, copy the tis-clone.cfg file to /etc, and then edit the /etc/tis-clone.cfg and make sure all the folder locations match your setup.
  • Get a TIS account at https://techinfo.toyota.com, log into it in your web browser on your desktop, then view your cookies and edit /tis-clone/cookies.txt to match. Note: you have to keep your web browser open while you're using the tools, and you'll need to occasionally refresh the web browser window every few hours by clicking a link somewhere inside it just to keep your session active.
  • Search TIS for your model year. There will be a (typically) 7-character code that is part of the URL for each manual section. You'll need the last 5 characters.
So for instance if the link to the Repair Manual for your 2019 Toyota Land Cruiser is techinfo.toyota.com/t3Portal/resources/jsp/siviewer/index.jsp?dir=rm/RM27J0U&locale=en&objType=rm&docid=en_rm_RM27J0U_RM100000000SXI0&publicationNumber=RM27J0U&docTitle=null&t3id=&home=null&User=false&modelyear=2019&pcd=08/2018-08/2019&langChanged=true&treeView=default&openSource=null&random=0.19485248116476094 then the manual name is "RM27J0U" and so the identifier for your model year is "27J0U" (as the leading "RM" means "Repair Manual".
  • Go to the working (download) folder and run all of the "dl-*" scripts which will download files for you. Typically you run them like "/tis-clone/scripts/dl-html-rm.sh 27J0U"
Note that sometimes the codes are the same for each section (i.e. RM27J0U, EM27J0U, BM27J0U, and NM27J0U for the 2016+ LC) but sometimes they are not (i.e. RM18X0U, EM18X0U, NM18X0U, but BM0800U for the 2013 LC). In those cases when you can either run all the scripts twice (which will take longer and will download some docs which aren't relevant) or you can run only the scripts you actually need)
  • Run the 'dl-framework' script to build out a usable local website
  • Run the 'tis-urlstripper' script to remove any links that point back to the TIS website, otherwise some of your pages will have broken links and images
  • If you want to create PDF files (optional), run the 'tis-mkpdfs.sh' script
  • Run the build-index (and optionally build-pdfidx) scripts to create website menus
  • Run the 'make-iso' script if you want to create your own personal ISO.
To view what you downloaded:
Help something isn't working!

If you've having trouble getting this to work, post your issue with lots of details, screenshots, etc of precisely what you're seeing here.

If you've found a bug, file it at Issues · rootflags/tis-clone - https://github.com/rootflags/tis-clone/issues.

Final thoughts

1640815052928.png
 
***** Edit ***** I got it to work on my PC

I have the "TheCompleteTLCFSM2021.iso" saved on my local drive and I went through the installation and setup of the Abyss web server per your instructions on GitHub. But when I go to "http://127.0.0.1/" it is giving me an index. I am using a mac and I have the ISO mounted. Any ideas? Would this be easier to use if I got a USB drive and installed the ISO on it? I am trying to get this figured out under pressure because I have a repair that I am in the middle of.... Thanks!
 
Last edited:
***** Edit ***** I got it to work on my PC

I have the "TheCompleteTLCFSM2021.iso" saved on my local drive and I went through the installation and setup of the Abyss web server per your instructions on GitHub. But when I go to "http://127.0.0.1/" it is giving me an index. I am using a mac and I have the ISO mounted. Any ideas? Would this be easier to use if I got a USB drive and installed the ISO on it? I am trying to get this figured out under pressure because I have a repair that I am in the middle of.... Thanks!
What files do you see when you go to http://127.0.0.1/ ?

Local ISO is faster and easier than a USB drive. The only reason to do the latter is if you want something more portable or if you don't have 40GB of disk space free.
 
What files do you see when you go to http://127.0.0.1/ ?

Local ISO is faster and easier than a USB drive. The only reason to do the latter is if you want something more portable or if you don't have 40GB of disk space free.
It only shows the "TheCompleteTLCFSM2021.iso"

Screen Shot 2022-05-11 at 1.21.56 PM.png
 
It only shows the "TheCompleteTLCFSM2021.iso"

View attachment 3006109
I'm not really familiar with MacOS, but if it sees the ISO, then it doesn't appear to be mounted. Once the ISO is mounted, it should appear as a drive. Did you point abyss at the right directory (i.e. the mounted drive).
 
It only shows the "TheCompleteTLCFSM2021.iso"

View attachment 3006109
As @lx200inAR notes, the ISO isn't mounted. Or at least wherever you're pointing the webserver to isn't the place you mounted it.

Did you right click on the ISO and select "mount"? If so, go to "This PC" and verify where you mounted it (D: or E: or whatever) and then go back to step 14 of the instructions at tis-clone/ABYSS.md at main · rootflags/tis-clone - https://github.com/rootflags/tis-clone/blob/main/ABYSS.md and make sure the drive letter you have in the "Documents Path" matches that.
 
That makes sense, I pointed abyss to the drive the iso is stored in. Once it’s mounted I assume that path is different
 
Fantastic. Thanks for putting all the work into this, @linuxgod . I'm going to give it a shot on my Mac with Homebrew/Apache. Also, I've got a Raspberry Pi just laying here, too, that might be a great option for a more garage-friendly manual. Thanks again!
 
Heres what the mounted drive looks like. screen grab from finder on a mac. and yes, you must mount and then point abyss at the mounted item

Screen Shot 2022-05-25 at 8.19.48 AM.png
 
And why would I use these?
What you are doing is kind of life saver to many Landcruiser owners. Most of us intend to or take our trucks to remote places where you either know theory and tell a mechanic how to do stuff or end up doing on your own. For most of us dealer network, recovery services are out of question. Ideally Toyota should supply these free of cost, knowing how Landcruisers are being used.
 

Users who are viewing this thread

Back
Top Bottom