# kkFileView ### Introduction Document online preview project solution, built using the popular Spring Boot framework for easy setup and deployment. This versatile open source project provides basic support for a wide range of document formats, including: 1. Supports Office documents such as `doc`, `docx`, `xls`, `xlsx`, `xlsm`, `ppt`, `pptx`, `csv`, `tsv`, etc. 2. Supports domestic WPS Office documents such as `wps`, `dps`, et. 3. Supports OpenOffice, LibreOffice office documents such as `odt`, `ods`, `ots`, `odp`, `otp`, `six`, `ott`, `fodt` and `fods`. 4. Supports Visio flowchart files such as `vsd`, `vsdx`. 5. Supports Windows system image files such as `wmf`, `emf`. 6. Supports Photoshop software model files such as `psd`. 7. Supports document formats like `pdf`, `ofd`, and `rtf`. 8. Supports software model files like `xmind`. 9. Supports document type files such as `eml`, `epub`. 10. Supports 3D model files like `obj`, `3ds`, `stl`, `ply`, `gltf`, `glb`, `off`, `3dm`, `fbx`, `dae`, `wrl`, `3mf`, `ifc`, `brep`, `step`, `iges`, `fcstd`, `bim`, etc. 11. Supports CAD model files such as `dwg`, `dxf`. 12. Supports all plain text files such as `txt`, `xml` (rendering), `md` (rendering), `java`, `php`, `py`, `js`, `css`, etc. 13. Supports compressed packages such as `zip`, `rar`, `jar`, `tar`, `gzip`, `7z`, etc. 14. Supports image previewing (flip, zoom, mirror) of `jpg`, `jpeg`, `png`, `gif`, `bmp`, `ico`, `jfif`, `webp`, etc. 15. Supports image information model files such as `tif` and `tiff`. 16. Supports image format files such as `tga`. 17. Supports vector image format files such as `svg`. 18. Supports many audio and video format files such as `avi`, `mov`, `wmv`, `mkv`, `3gp`, and `rm`. ### Features - Build with the popular frame spring boot - Easy to build and deploy - Basically support online preview of mainstream office documents, such as Doc, docx, Excel, PDF, TXT, zip, rar, pictures, etc - REST API - Abstract file preview interface so that it is easy to extend more file extensions and develop this project on your own ### Official website and DOCS URL：[https://kkview.cn](https://kkview.cn/) ### Live demo > Please treat public service kindly, or this would stop at any time. URL：[https://kkview.cn/preview/index](https://kkview.cn/preview/index) ### Documentation 1. Full wiki document：https://gitee.com/kekingcn/file-online-preview/wikis/pages 1. 中文文档：https://gitee.com/kekingcn/file-online-preview/blob/master/README.md 1. English document：https://gitee.com/kekingcn/file-online-preview/blob/master/README.en.md ### Contact us && Join us > We will answer everyone's questions in use of this project. And please Google or Baidu first before asking a question, so that we can solve it efficiently. Cherish life away from ineffective communication. ![](./doc/知识星球.png) ### Pictures for some samples #### 1. Text Preview It supports preview of all types of text documents. Because there are too many types of text documents, it is impossible to enumerate them. The default open types are as follows: txt,html,htm,asp,jsp,xml,json,properties,md,gitignore,log,java,py,c,cpp,sql,sh,bat,m,bas,prg,cmd The text preview effect is as follows ![text](https://kkview.cn/img/preview/preview-text.png) #### 2. Picture preview Support jpg, jpeg, png, gif and other picture previews (flip, zoom, mirror). The preview effect is as follows ![image](https://kkview.cn/img/preview/preview-image.png) #### 3. Word document preview Doc and docx document previews are supported. There are two modes of word previews: one is that each page of word is converted to picture previews, the other is that the whole word document is converted to PDF, and then previews PDF. The applicable scenarios of the two modes are as follows * Picture preview modes: the word file is large, and the whole PDF loaded in the foreground is too slow * Pdf Preview modes: intranet access, loading PDF fast The preview effect of picture preview mode is as follows ![word1](https://kkview.cn/img/preview/preview-doc-image.png) The preview effect of PDF preview mode is as follows ![word2](https://kkview.cn/img/preview/preview-doc-pdf.png) #### 4. PPT document preview ppt and pptx document preview are supported. Like word documents, there are two preview modes The preview effect of picture preview mode is as follows ![ppt1](https://kkview.cn/img/preview/preview-ppt-image.png) The preview effect of PDF preview mode is as follows ![ppt2](https://kkview.cn/img/preview/preview-ppt-pdf.png) #### 5. PDF document preview Pdf document preview is supported. Like word document, there are two preview modes The preview effect of picture preview mode is as follows ![pdf1](https://kkview.cn/img/preview/preview-pdf-image.png) The preview effect of PDF preview mode is as follows ![pdf2](https://kkview.cn/img/preview/preview-pdf-pdf.png) #### 6. EXCEL document preview Support XLS, xlsx document preview, the preview effect is as follows ![excel](https://kkview.cn/img/preview/preview-xls.png) #### 7. Compressed file Preview Support zip, rar, jar, tar, gzip and other compressed packages. The preview effect is as follows ![compress1](https://kkview.cn/img/preview/preview-zip.png) Click the file name in the compressed package to preview the file directly. The preview effect is as follows ![compress2](https://kkview.cn/img/preview/preview-zip-inner.png) #### 8. Multimedia file Preview Theoretically, all video and audio files are supported. Since all file formats cannot be enumerated, the default open type is as follows mp3,wav,mp4,flv The video preview effect is as follows ![media1](https://kkview.cn/img/preview/preview-video.png) The audio preview effect is as follows ![media2](https://kkview.cn/img/preview/preview-audio.png) #### 9. CAD document preview CAD DWG document preview is supported. Like word document, there are two preview modes The preview effect of Picture preview mode is as follows ![cad1](https://kkview.cn/img/preview/preview-cad-image.png) The preview effect of PDF preview mode is as follows ![cad2](https://kkview.cn/img/preview/preview-cad-pdf.png) Considering space issues, the pictures of other types of documents will not be shown here.You can deploy it by yourself if you are interested in our project.There is a way to deploy it as below. ### Quick Start > Technology stack - Spring boot： [spring boot Development Reference Guide](http://www.kailing.pub/PdfReader/web/viewer.html?file=springboot) - Freemarker - Redisson - Jodconverter > Dependencies - Redis(Optional, Unnecessary by default) - OpenOffice or LibreOffice(Integrated on Windows, will be installed automatically on Linux, need to be manually installed on Mac OS) 1. First step：`git pull https://github.com/kekingcn/file-online-preview.git` 2. Third step：Run the main method of FilePreviewApplication.java.After starting,visit `http://localhost:8012/`. If everything is ok,you will see the picture below. ![输入图片说明](https://gitee.com/uploads/images/2017/1213/100221_ea15202e_492218.png "屏幕截图.png") ### Changelog > December 14, 2022, version 4.1.0 released: 1. Updated homepage design by @wsd7747. 2. Compatible with multipage tif for pdf and jpg conversion and multiple page online preview for tif image preview by @zhangzhen1979. 3. Optimized docker build, using layered build method by @yl-yue. 4. Implemented file encryption based on userToken cache by @yl-yue. 5. Implemented preview for encrypted Word, PPT, and Excel files by @yl-yue. 6. Upgraded Linux & Docker images to LibreOffice 7.3. 7. Updated OFD preview component, tif preview component, and added support for PPT watermarking. 8. Numerous other upgrades, optimizations, and bug fixes. We thank @yl-yue, @wsd7747, @zhangzhen1979, @tomhusky, @shenghuadun, and @kischn.sun for their code contributions. > July 6, 2021, version 4.0.0 released: 1. The integration of OpenOffice in the underlying system has been replaced with LibreOffice, resulting in enhanced compatibility and improved preview effects for Office files. 2. Fixed the directory traversal vulnerability in compressed files. 3. Fixed the issue where previewing PPT files in PDF mode was ineffective. 4. Fixed the issue where the front-end display of image preview mode for PPT files was abnormal. 5. Added a new feature: the file upload function on the homepage can be enabled or disabled in real-time through configuration. 6. Optimized the logging of Office process shutdown. 7. Optimized the logic for finding Office components in Windows environment, with built-in LibreOffice taking priority. 8. Optimized the synchronous execution of starting Office processes. > June 17, 2021, version 3.6.0 released: This version includes support for OFD file type versions, and all the important features in this release were contributed by the community. We thank @gaoxingzaq and @zhangxiaoxiao9527 for their code contributions. 1. Added support for previewing OFD type files. OFD is a domestically produced file format similar to PDF. 2. Added support for transcoding and previewing video files through ffmpeg. With transcoding enabled, theoretically, all mainstream video file formats such as RM, RMVB, FLV, etc. are supported for preview. 3. Beautified the preview effect of PPT and PPTX file types, much better looking than the previous version. 4. Updated the versions of dependencies such as pdfbox, xstream, common-io. > January 28, 2021: The final update of the Lunar New Year 2020 has been released, mainly including some UI improvements, bug fixes reported by QQ group users and issues, and most importantly, it is a new version for a good year. 1. Introduced galimatias to solve the problem of abnormal file download caused by non-standard file names. 2. Updated UI style of index access demonstration interface. 3. Updated UI style of markdown file preview. 4. Updated UI style of XML file preview, adjusted the architecture of text file preview to facilitate expansion. 5. Updated UI style of simTxT file preview. 6. Adjusted the UI of continuous preview of multiple images to flip up and down. 7. Simplified all file download IO operations by adopting the apache-common-io package. 8. XML file preview supports switching to pure text mode. 9. Enhanced prompt information when url base64 decoding fails. 10. Fixed import errors and image preview bug. 11. Fixed the problem of missing log directory when running the release package. 12. Fixed the bug of continuous preview of multiple images in the compressed package. 13. Fixed the problem of no universal matching for file type suffixes in uppercase and lowercase. 14. Specified the use of the Apache Commons-code implementation for Base64 encoding to fix exceptions occurring in some JDK versions. 15. Fixed the bug of HTML file preview of text-like files. 16. Fixed the problem of inability to switch between jpg and pdf when previewing dwg files. 17. Escaped dangerous characters to prevent reflected xss. 18. Fixed the problem of duplicate encoding causing the failure of document-to-image preview and standardized the encoding. > December 27, 2020: The year-end major update of 2020 includes comprehensive architecture design, complete code refactoring, significant improvement in code quality, and more convenient secondary development. We welcome you to review the source code and contribute to building by raising issues and pull requests. 1. Adjusted architecture modules, extensively refactored code, and improved code quality by several levels. Please feel free to review. 2. Enhanced XML file preview effect and added preview of XML document structure. 3. Added support for markdown file preview, including support for md rendering and switching between source text and preview. 4. Switched the underlying web server to jetty, resolving the issue: https://github.com/kekingcn/kkFileView/issues/168 5. Introduced cpdetector to solve the problem of file encoding recognition. 6. Adopted double encoding with base64 and urlencode for URLs to completely solve preview problems with bizarre file names. 7. Added configuration item office.preview.switch.disabled to control the switch of office file preview. 8. Optimized text file preview logic, transmitting content through Base64 to avoid requesting file content again during preview. 9. Disabled the image zoom effect in office preview mode to achieve consistent experience with image and pdf preview. 10. Directly set pdfbox to be compatible with lower version JDK, and there will be no warning prompts even when run in IDEA. 11. Removed non-essential toolkits like Guava and Hutool to reduce code volume. 12. Asynchronous loading of Office components speeds up application launch to within 5 seconds. 13. Reasonable settings of the number of threads in the preview consumption queue. 14. Fixed the bug where files in compressed packages failed to preview again. 15. Fixed the bug in image preview. > May 20th 2020 ： 1. Support for global watermark and dynamic change of watermark content through parameters 2. Support for CAD file Preview 3. Add configuration item base.url, support using nginx reverse proxy and set context-path 4. All configuration items can be read from environment variables, which is convenient for docker image deployment and large-scale use in cluster 5. Support the configuration of TrustHost (only the file source from the trust site can be previewed), and protect the preview service from abuse 6. Support configuration of customize cache cleanup time (cron expression) 7. All recognizable plain text can be previewed directly without downloading, such as .md .java .py, etc 8. Support configuration to limit PDF file download after conversion 9. Optimize Maven packaging configuration to solve the problem of line break in .sh script 10. Place all CDN dependencies on the front end locally for users without external network connection 11. Comment Service on home page switched from Sohu ChangYan to gitalk 12. Fixed preview exceptions that may be caused by special characters in the URL 13. Fixed the addtask exception of the transformation file queue 14. Fixed other known issues 15. Official website build: [https://kkview.cn](https://kkview.cn) 16. Official docker image repository build: [https://hub.docker.com/r/keking/kkfileview](https://hub.docker.com/r/keking/kkfileview) > June 18th 2019 ： 1. Support automatic cleaning of cache and preview files 2. Support http/https stream url file preview 3. Support FTP url file preview 4. Add Docker build > April 8th 2019 1. Cache and queue implementations abstract, providing JDK and REDIS implementations (REDIS becomes optional dependencies) 2. Provides zip and tar.gz packages, and provides a one-click startup script > January 17th 2018 1. Refined the project directory, abstract file preview interface, Easy to extend more file extensions and depoly this project on your own 1. Added English documentation (@幻幻Fate，@汝辉) contribution 1. Support for more image file extensions 1. Fixed the issue that image carousel in zip file will always start from the first > January 12th 2018 1. Support for multiple images preview 1. Support for images rotation preview in rar/zip > January 2nd 2018 1. Fixed gibberish issue when preview a txt document caused by the file encoding problem 1. Fixed the issue that some module dependencies can not be found 1. Add a spring boot profile, and support for Multi-environment configuration 1. Add `pdf.js` to preview the documents such as doc,etc.,support for generating doc headlines as pdf menu，support for mobile preview ### Sponsor Us If this project has been helpful to you, we welcome your sponsorship. Your support is our greatest motivation.！