You want to contribute to vimiv? Great! Every little help counts and is appreciated!
Any feedback is welcome! Did you find something unintuitive? Not clearly documented? Do you have a great idea for a new feature? Let me know! You can either open an issue directly on github or contact me directly if you prefer.
You like vimiv? Share some love and spread the word!
The best way to report bugs is to open an issue on github. If you do not have a github account,
feel free to contact me directly. If possible, please
reproduce the bug running
vimiv --log-level debug and include the log file located
$XDG_DATA_HOME is usually
~/.local/share/ if you have not configured it.
You probably already know what you want to work on as you are reading this page. If you want to implement a new feature, it might be a good idea to open a feature request on the issue tracker first. Otherwise you might be disappointed if I do not accept your pull request because I do not feel like this should be in the scope of vimiv.
If you want to find something to do, check the issue tracker. Some hints:
As this is my first larger project, comments and improvements to the existing code base are more than welcome.
If you like, you can also find some more information on hacking the source code.
More documentation is always useful! Here are some options where this could be done:
Improving the website. Is something unclear or missing?
Extending and improve the docstrings in the code base.
Writing blog posts, articles, … All of them are appreciated! If you like, they can also be linked here.
In case you chose to update the website, here are some more tips. The website is written in resturctured Text (reST) and built using sphinx. A great introduction is given by the reST Primer of sphinx.
You can find the reST files used to build the website in the project’s
If you would like to build a local copy, you can run:
tox -e docs -- path/to/copy
You can then browse your local build: