search

3dfsb-dev / 3dfsb

3D File System Browser - improved, cleaned up and maintained fork of the old tdfsb
GNU General Public License v2.0
97 stars 10 forks source link

readme

3dfsb

3D File System Browser - cleaned up and improved fork of the old tdfsb which runs on GNU/Linux and should also run on BeOS/Haiku and FreeBSD. Forked, cleaned up and improved by Tom Van Braeckel, originally written by Leander Seige.

Project homepage: https://github.com/3dfsb-dev/3dfsb

Mailing list: 3dfsb-dev@googlegroups.com and https://groups.google.com/forum/#!forum/3dfsb-dev

News

Biggest improvements

Performance

This version runs at 1920x1080 resolution while playing 720p H264 video (2048x2048 texture) on a single-core of the Intel Core i7 at 2.90Ghz.

Screenshots

Screenshot: all major audio and video formats are supported through GStreamer. Video texture size went up from 256x256 to however high your GPU can go. Think 8192x8192. Above: all major audio and video formats are supported through GStreamer. Video texture size went up from 256x256 to however high your GPU can go. Think 8192x8192.

Screenshot: hardware device files (such as webcams) are visible in the 3D world and can be accessed from it. Above: hardware device files (such as webcams) are visible in the 3D world and can be accessed from it.

Screenshot: filetype detection is much more robust and versatile, relying on libmagic to identify a filetype by its contents. The old method, which is based on filename extensions, is used as a fallback. Above: filetype detection is much more robust and versatile, relying on libmagic to identify a filetype by its contents. The old method, which is based on filename extensions, is used as a fallback.

Screenshot: you can use different tools to operate on your files, for example: blast them with the laser to delete them! And don't worry: for safety reasons, the program doesn't actually delete them from your disk unless you explicitly configure it to do so. Above: you can use different tools to operate on your files, for example: blast them with the laser to delete them! And don't worry: for safety reasons, the program doesn't actually delete them from your disk unless you explicitly configure it to do so.

Screenshot: Open files and run programs in the 3D World Above: an OpenDocument Text file is opened with its default handler (LibreOffice) in the 3D world.

USAGE

3dfsb

or

3dfsb --version

or

3dfsb -D /path/to/dir

or

3dfsb --dir /path/to/dir

Dependencies

Compilation libraries:

You need imagemagick's "mogrify" tool to convert the built-in image files to pnm files and also the xxd tool.

Hint: sudo apt-get install imagemagick

Development libraries:

You may need to install 'devel' packages of these libraries in order to get the necessary .h files and the sdl-config script.

On Ubuntu, you can install all build-time dependencies with:

sudo apt-get install build-essential freeglut3-dev libsdl-image1.2-dev libsdl1.2-dev libxi-dev libxmu-dev libmagic-dev imagemagick libxtst-dev libxdo-dev

For GStreamer, you need: sudo apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev

And if you want all GStreamer codecs and plugins, use:

sudo apt-get install gstreamer1.0-plugins-* gstreamer1.0-libav

(And for pulseaudio, but this is not being used currently but might be someday: sudo apt-get install gstreamer1.0-pulseaudio)

Compilation

There is a small shell script which contains a standard compile string for every OS (Linux, BeOS and BSD). So please try:

./compile.sh

Alternatively, CMake can be used to compile. Run:

rm CMakeCache.txt # To be sure the cache is clean, not necessary every time cmake . make

If the compilation was successful you can call the 3dfsb:

./3dfsb

ADDITIONAL NOTES

FreeBSD:

If you have problems with SDL_image try: cd /usr/ports/graphics/sdl_image/ make install

BeOS/Haiku:

This package does not contain a BeOS binary, because I don't have BeOS/Haiku installed on my computer anymore.

Compile the code report any issues you may experience.

NVidia Cards under Linux (+FreeBSD?)

NVidia users who have problems compiling the 3dfsb are often linking against the wrong libraries, especially the libGLU.so. In this case please read the instructions that came with your drivers. The following often helped but of course i can give no guarantee, try it on your own risk! There are two libGLU.so's. Move the original libGLU.so to a safe place (libGLU.so.my.original or something). Make a link libGLU.so->libGLU.so.the.right.one. libGLU.so.the.right.one is often >500kByte while the wrong libGLU.so is much smaller.

CREDITS

Maintained, improved and cleaned up by Tom Van Braeckel.

Thanks go out to:

History

25/12/2014: Tom Van Braeckel here; I've picked up where Leander left off. I'm cleaning up the code and adding features, see CHANGELOG!

22/06/2007: Leander Seige: "TDFSB is 6 years old now and I havent done anything on it for a long time. Today I would code a lot of things very different - better i hope - than years ago. But, so what, it still works and I got very less bug reports on 3dfsb. Some days ago I installed Gentoo for the first time and I heared that someone (thank you!) build a package for Gentoo so I tried emerge 3dfsb and it worked :) Besides that it has problems with freeglut which I quickly fixed now. So I hope some people, YOU, still like it. Have fun!"