{"id":13466872,"url":"https://github.com/ValveSoftware/vogl","last_synced_at":"2025-03-26T00:31:39.604Z","repository":{"id":14960121,"uuid":"17684902","full_name":"ValveSoftware/vogl","owner":"ValveSoftware","description":"OpenGL capture / playback debugger.","archived":false,"fork":false,"pushed_at":"2017-11-21T14:55:19.000Z","size":64415,"stargazers_count":1422,"open_issues_count":95,"forks_count":124,"subscribers_count":128,"default_branch":"master","last_synced_at":"2025-03-19T11:11:26.148Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ValveSoftware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-12T21:33:00.000Z","updated_at":"2025-03-03T06:18:52.000Z","dependencies_parsed_at":"2022-09-01T12:50:13.220Z","dependency_job_id":null,"html_url":"https://github.com/ValveSoftware/vogl","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValveSoftware%2Fvogl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValveSoftware%2Fvogl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValveSoftware%2Fvogl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValveSoftware%2Fvogl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ValveSoftware","download_url":"https://codeload.github.com/ValveSoftware/vogl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245566099,"owners_count":20636391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T15:00:50.918Z","updated_at":"2025-03-26T00:31:37.590Z","avatar_url":"https://github.com/ValveSoftware.png","language":"C++","readme":"vogl\n=============\n\n#### NOTE ####\n\nApril 16, 2014: Vogl history has been completely and utterly trounced. The original repository had an entire chroot build system that most folks weren't interested in. A few contributors (thanks Carl \u0026 Sir Anthony) took the time to build a much smaller source only vogl repository which we've replaced the original one with.\n\nA separate chroot repository (which will build this source repository) is now here:\n\nhttps://bitbucket.org/raddebugger/vogl_chroot\n\n## Warning ##\n\nThis project is alpha^2. If you are up for suffering through a bit of pain with early releases, please jump in - we'd love to have your help...\n\n## Dependencies ##\n\nThe chroot configuration script should be a good reference for vogl dependencies. It is located here:\n\nhttps://bitbucket.org/raddebugger/vogl_chroot/src/master/bin/chroot_configure.sh?at=master\n\nThe build dependencies for ubuntu (14.04) can be installed using the following:\n```\nsudo apt-get install build-essential pkg-config cmake libx11-dev \\\n                     zip wget libtinyxml-dev liblzma-dev libunwind8-dev \\\n                     libturbojpeg libdwarf-dev mesa-common-dev qt5-qmake\\\n                     freeglut3-dev qt5-default libqt5x11extras5-dev git \\\n                     libsdl2-gfx-dev libsdl2-image-dev libsdl2-ttf-dev libjpeg-turbo8-dev\n```\n\n## Get Source and Build ##\n\n#### Linux ####\n\n```\ngit clone https://github.com/ValveSoftware/vogl.git  \nmkdir -p vogl/vogl_build/release64 \u0026\u0026 cd $_  \ncmake -DCMAKE_BUILD_TYPE=Release -DBUILD_X64=On ../..\nmake -j 10\n```\n\nThe binaries are placed in the vogl/vogl_build directory.\n\nFor debug builds, use \"-DCMAKE_BUILD_TYPE=Debug\"  \nFor 32-bit builds, use \"-DBUILD_X64=Off\"  \n\n#### Windows ####\n\n```\ngit clone https://github.com/ValveSoftware/vogl.git\nmkdir -p vogl\\vogl_build\\x64\ncd vogl\\vogl_build\\x64\ncmake -DQt5_DIR=\"C:\\Qt\\5.3\\msvc2013_64_opengl\\lib\\cmake\\Qt5\" -G \"Visual Studio 12 2013 Win64\" ..\\..\ncd ..\\..\\..\\\nmkdir -p vogl\\vogl_build\\win32\ncd vogl\\vogl_build\\win32\ncmake -DQt5_DIR=\"C:\\Qt\\5.3\\msvc2013_opengl\\lib\\cmake\\Qt5\" -G \"Visual Studio 12 2013\" ..\\..\n```\n\nNote: The path to Qt5 might need to be adjusted depending on your install location.\nAfter compiling with Visual Studio, the binaries are placed in the vogl\\vogl_build\\Release (or Debug) directory.\n\n### Mac OS X ###\n\nInstall the required build dependencies using Homebrew:\n\n```\nbrew install pkg-config cmake sdl2 qt5 xz jpeg-turbo tinyxml\n```\n\nThen build with:\n\n```\ngit clone https://github.com/ValveSoftware/vogl.git\n\nmkdir -p vogl/vogl_build/mac\ncd       vogl/vogl_build/mac\n\ncmake ../.. -DCMAKE_PREFIX_PATH=/usr/local/Cellar/qt5/5.3.2/\nmake\n```\n\nNote: the Mac port is not yet functional.\n\n## Capturing ##\n\n```\ncd vogl_build\nVOGL_CMD_LINE=\"--vogl_tracefile vogltrace.glxspheres64.bin\" LD_PRELOAD=$(readlink -f libvogltrace64.so) ./glxspheres64  \n```\n\nFor capturing Steam games, please see the vogl_trace.sh script in the chroot repository:\n\nhttps://bitbucket.org/raddebugger/vogl_chroot/src/master/bin/src/sl.cpp?at=master\n\nWe are currently working on making it much easier to launch and profile Steam apps.\n\n## Replay ##\n\n```\n./voglreplay64 play vogltrace.glxspheres64.bin\n```\n\nor launch `vogleditor64` and open trace file.\n\n## QtCreator tagging and building ##\n\n  See qtcreator/qtcreator.md file: [qtcreator.md](qtcreator/qtcreator.md)\n\n## Vogl Dev List ##\n\n  http://lists.voglproj.com/listinfo.cgi/dev-voglproj.com\n\n## Useful Links ##\n\nVogl Wiki\n\n* https://github.com/ValveSoftware/vogl/wiki\n\nOpenGL documentation/references\n\n* 4.x: http://www.opengl.org/sdk/docs/man/\n* 3.3: http://www.opengl.org/sdk/docs/man3/\n* 2.1: http://www.opengl.org/sdk/docs/man2/\n\nSpecifications\n\n* 4.0: http://www.opengl.org/registry/doc/glspec40.core.20100311.pdf\n* 3.3: http://www.opengl.org/registry/doc/glspec33.core.20100311.withchanges.pdf\n* 2.1: http://www.opengl.org/documentation/specs/version2.1/glspec21.pdf\n\n## License and Credits ##\n\nVogl code is [MIT](http://opensource.org/licenses/MIT) licensed. \n\n```\nCopyright 2013-2014 RAD Game Tools and Valve Software\n\nAll Rights Reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n```\n\nlibbacktrace is BSD licensed. [Libbacktrace license](https://github.com/mirrors/gcc/blob/master/libbacktrace/README).\n\napitrace is MIT licensed: [Apitrace license](https://github.com/apitrace/apitrace/blob/master/LICENSE).\n\nLoki is MIT licensed: [Loki license](http://loki-lib.sourceforge.net/index.php?n=Main.License).\n\nValgrind header files are BSD-style licensed: [Valgrind header files](http://valgrind.org/docs/manual/manual-intro.html).\n\nGL header files are MIT licensed: [GL header files](http://www.opengl.org/registry/).\n\nglxspheres (from VirtualGL) is wxWindows Library licensed: [wxWindows Library License](http://www.virtualgl.org/About/License).\n\nSDL is zlib licensed: [zlib license](http://www.libsdl.org/license.php).\n\nstb files (from Sean Barrett) are public domain.\n\nTinyXML-2 is zlib licensed: [zlib license](https://github.com/leethomason/tinyxml2).\n\n","funding_links":[],"categories":["C++","Debug","Graphics"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValveSoftware%2Fvogl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FValveSoftware%2Fvogl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FValveSoftware%2Fvogl/lists"}