-
Notifications
You must be signed in to change notification settings - Fork 100
V0.4 Troubleshooting Installation Issues
This page is currently under construction. I'm trying to get Octolapse V0.4 stable released ASAP at the moment, and this has led to some documentation shortcuts. As you might know, Octolapse v4.0 has a TON of documentation built right into the plugin that may help. Click on the various help icons (blue question marks) throughout the system to see detailed help on almost every setting. There are also help buttons that will show up for many error notifications. ALWAYS click on those if you need help.
It can be frustrating when an installation fails. I am very aware of this, and have sometimes struggled to solve installation issues for users. It is very difficult at times to get software to install properly on multiple platforms, and the Octolapse installation is quite complicated.
In this guide I attempt to list as many of the common problems as possible, along with the solutions that have worked for some people. I must admit, there are still some installation issues that haven't been solved 100%. Please let me know if you have one of these.
This error is caused because the Python development package is not installed. Octolapse needs this so it can compile a C++ extension.
As of now, OctoPi ships with the Python dev package, but ONLY for Python 2.7. If you are running Python 3, you will need to install the package manually.
If you are NOT running OctoPi and Python 2.7 (this comes pre-installed), you may need to install Python-dev.
[Open a terminal window|0.4---Connecting-To-Terminal-Remotely) and run one of the following commands depending on the Python version you are using.
For Python 2:
sudo apt-get install python-dev
For Python 3:
sudo apt-get install python3-dev
The Python includes are typically installed by default when running the Python installer. You should find a sub-directory within the Python installation folder called include. If you do not see this, re-run the installer and pay attention to the options. I've actually not found any instances where the includes were not installed, but if this happens to you, please report an issue and I'll update these instructions.
Typically the Python devel package is included, but if it is not, you can install it via brew with the following command:
brew reinstall python
I do not have access to a Mac for testing, so if you have better instructions, please create an issue and I'll update the instructions!
Pillow is a critical library that handles all image manipulations, including creating thumbnails, rotating images, detecting image formats, etc. Unfortunately the installation is sometimes problematic. I've not found a single solution to fix Pillow installation issues, but I do know several ways that people have fixed it in the past.
Old versions of pip seem to have more problems installing Pillow. Try upgrading pip by first [connecting to a terminal window|0.4---Connecting-To-Terminal-Remotely).
Now you will need to activate the virtual environment that OctoPrint is installed into. If you are using OctoPi, these steps will work:
source ~/oprint/bin/activate
pip install --upgrade pip
The first line activates the virtual environment. After the environment is activated, the pip command will apply to that environment.
Now try re-installing Octolapse.
For some reason, occasionally a manual installation of Pillow will work, even though it fails when using OctoPrint.
Pillow has some prerequisites that must be installed first, so run this command to ensure they are all installed:
sudo apt-get install libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev
This may take a while to install. Once it's completed, activate your virtual environment and attempt to install Pillow manually. If you are running OctoPi, these commands should work:
source ~/oprint/bin/activate
pip --no-cache-dir install pillow
Pillow will take a while to install. Once it has completed successfully, try reinstalling Octolapse.
You might want to read the official pillow installation instructions found here.
The instructions are focused on Python 3. If you are using Python 2, the commands shown will not help you.
If you are running OctoPi on a Raspberry Pi, I recommend trying a fresh install of OctoPi. It could be that something went wrong during an update or previous installation that is causing an obscure problem. I realize that reflashing takes a lot of time and effort, but it is a good way to narrow down the problem, and it may just solve other issues too. I recommend utilizing the Backup and Restore plugin, which is built into OctoPrint 1.4.0 and above. That way you won't lose all of your settings and files. You might also consider flashing onto a new SD card so that you can easily move back and forth between your new and old installation.
If that fails too, or if you are just unwilling to reflash, consider V0.4---Reporting-An-Issue. Be sure to include a copy of your plugin_pluginmanager_console.log file, the steps you've already taken to try and fix the problem, and as much other information as you can provide.
Octolapse is provided without warranties of any kind. By installing Octolapse you agree to accept all liability for any damage caused directly or indirectly by Octolapse.
Use caution and never leave your printer unattended.
If you have a great new guide, see a typo, or have other suggestions for improving the existing documentation, please let me know! You can either submit a feature request or submit a pull request. I would appreciate it greatly!
Consider supporting Octolapse by becoming a Patron, a Github Sponsor, or by sending some coffee/beer money, I would REALLY appreciate it. Almost all of the donations go towards offsetting the cost of development, which are substantial. Plus it always makes my day!
If you cannot afford to leave a tip or just don't want to, that is fine too! Octolapse is free and open source after all. There are other ways you can help ensure that Octolapse continues to be updated and improved:
- Share your Octolapse videos, and be sure to leave a link and explain that the timelapses were captured with Octolapse and OctoPrint (you will be asked how you made the timelapse, so this will also save you some time answering questions). This is not necessary, but it is greatly appreciated.
- Subscribe to my youtube channel.
- Post any bugs you find to the Issues Page. I would like to eliminate as many bugs as possible!
- Participate in the OctoPrint Community Forums, and help all the noobs get OctoPrint and Octolapse working and help expand the hobby. The more people use OctoPrint and Octolapse, the better the software will become!
- If you've created a working and tested printer profile for any printers that aren't in the make/model list, please send it to me! I want to make it as easy as possible for new users to get their printers configured quickly.
- Help me make this documentation better! Octolapse has a LOT of documentation, guides, tips, etc., both here in the Wiki and integrated with the Octolapse plugin. If you find inaccuracies, typos, gaps, or have ideas for improvement, I'd love to hear about them.
- If you have any special talents that could be applied to Octolapse development, like graphic design, video production (think tutorials), programming, etc., maybe you'd like to participate more directly in Octolapse development/documentation?