README.md

   1 <p align=center>
   2   <img src="https://reactos.org/wiki/images/0/02/ReactOS_logo.png">
   3 </p>
   4
   5 ---
   6
   7 <p align=center>
   8   <a href="https://reactos.org/project-news/reactos-049-released">
   9     <img alt="ReactOS 0.4.9 Release" src="https://img.shields.io/badge/release-0.4.9-0688CB.svg">
  10   </a>
  11   <a href="https://reactos.org/download">
  12     <img alt="Download ReactOS" src="https://img.shields.io/badge/download-latest-0688CB.svg">
  13   </a>
  14   <a href="https://sourceforge.net/projects/reactos">
  15     <img alt="SourceForge Download" src="https://img.shields.io/sourceforge/dm/reactos.svg?colorB=0688CB">
  16   </a>
  17   <a href="https://github.com/reactos/reactos/blob/master/COPYING">
  18     <img alt="License" src="https://img.shields.io/badge/license-GNU_GPL_2.0-0688CB.svg">
  19   </a>
  20   <a href="https://reactos.org/donating">
  21     <img alt="Donate" src="https://img.shields.io/badge/%24-donate-E44E4A.svg">
  22   </a>
  23   <a href="https://twitter.com/reactos">
  24     <img alt="Follow on Twitter" src="https://img.shields.io/twitter/follow/reactos.svg?style=social&label=Follow%20%40reactos">
  25   </a>
  26 </p>
  27
  28 ## Quick Links
  29
  30 - [Website](https://reactos.org)
  31 - [Wiki](https://reactos.org/wiki)
  32 - [Forum](https://reactos.org/forum)
  33 - [JIRA Bug Tracker](https://jira.reactos.org/issues)
  34 - [ReactOS Git mirror](https://git.reactos.org)
  35 - [Testman](https://reactos.org/testman/)
  36
  37 ## What is ReactOS?
  38
  39 ReactOS™ is an Open Source effort to develop a quality operating system that is compatible with applications and drivers written for the Microsoft® Windows™ NT family of operating systems (NT4, 2000, XP, 2003, Vista, Seven).
  40
  41 The ReactOS project, although currently focused on Windows Server 2003 compatibility, is always keeping an eye toward compatibility with Windows Vista and future Windows NT releases.
  42
  43 The code of ReactOS is licensed under [GNU GPL 2.0](https://github.com/reactos/reactos/blob/master/COPYING).
  44
  45 ## Building
  46
  47 [![appveyor.badge]][appveyor.link] [![travis.badge]][travis.link] [![rosbewin.badge]][rosbewin.link] [![rosbeunix.badge]][rosbeunix.link] [![coverity.badge]][coverity.link]
  48
  49 To build the system it is strongly advised to use the _ReactOS Build Environment (RosBE)._
  50 Up-to-date versions for Windows and for Unix/GNU-Linux are available from our download page at: http://www.reactos.org/wiki/Build_Environment.
  51
  52 Alternatively one can use Microsoft Visual C++ (MSVC) version 2010+. Building with MSVC is covered here: https://www.reactos.org/wiki/Building_with_MSVC.
  53
  54 ### Binaries
  55
  56 To build ReactOS you must run the `configure` script in the directory you want to have your build files. Choose `configure.cmd` or `configure.sh` depending on your system. Then run `ninja <modulename>` to build a module you want or just `ninja` to build all modules.
  57
  58 ### Bootable images
  59
  60 To build a bootable CD image run `ninja bootcd` from the
  61 build directory. This will create a CD image with a filename `bootcd.iso`.
  62
  63 See ["Building ReactOS"](http://www.reactos.org/wiki/Building_ReactOS) for more details.
  64
  65 You can always download fresh binary builds of bootable images from the ["Daily builds"](https://www.reactos.org/getbuilds/) page.
  66
  67 ## Installing
  68
  69 By default, ReactOS currently can only be installed on a machine that has a FAT16 or FAT32 partition as the active (bootable) partition.
  70 The partition on which ReactOS is to be installed (which may or may not be the bootable partition) must also be formatted as FAT16 or FAT32.
  71 ReactOS Setup can format the partitions if needed.
  72
  73 Starting 0.4.10, ReactOS can be installed using the BtrFS file system. But
  74 consider this as an experimental feature and thus regressions not triggered on
  75 FAT setup may be observed.
  76
  77 To install ReactOS from the bootable CD distribution, extract the archive contents. Then burn the CD image, boot from it, and follow the instructions.
  78
  79 See ["Installing ReactOS"](https://www.reactos.org/wiki/Installing_ReactOS) Wiki page or [INSTALL](INSTALL) for more details.
  80
  81 ## Testing
  82
  83 If you discover a bug in ReactOS search on JIRA first - it might be reported already. If not report the bug providing logs and as many information as possible.
  84
  85 See ["File Bugs"](https://www.reactos.org/wiki/File_Bugs) for a guide.
  86
  87 __NOTE:__ The bug tracker is _not_ for discussions. Please use `#reactos` Freenode IRC channel or our [forum](https://reactos.org/forum).
  88
  89 ## Contributing  ![prwelcome.badge]
  90
  91 We are always looking for developers! Check [how to contribute](CONTRIBUTING.md) if you are willing to participate.
  92
  93 You can also support ReactOS by [donating](https://reactos.org/donating)! We rely on our backers to maintain our servers and accelerate development by [hiring full-time devs](https://reactos.org/node/785).
  94
  95 ## More information
  96
  97 ReactOS is a Free and Open Source operating system based on the Windows architecture,
  98 providing support for existing applications and drivers, and an alternative to the current dominant consumer operating system.
  99
 100 It is not another wrapper built on Linux, like WINE. It does not attempt or plan to compete with WINE; in fact, the user-mode part of ReactOS is almost entirely WINE-based and our two teams have cooperated closely in the past.
 101
 102 ReactOS is also not "yet another OS". It does not attempt to be a third player like any other alternative OS out there. People are not meant to uninstall Linux and use ReactOS instead; ReactOS is a replacement for Windows users who want a Windows replacement that behaves just like Windows.
 103
 104 More information is available at: https://www.reactos.org.
 105
 106 Also see the [media/doc](/media/doc/) subdirectory for some sparse notes.
 107
 108 ## Who is responsible
 109
 110 Active devs are listed as members of [GitHub organization](https://github.com/orgs/reactos/people).
 111 See also the [CREDITS](CREDITS) file for others.
 112
 113 ## Code mirrors
 114
 115 The main development is done on [GitHub](https://github.com/reactos/reactos). We have an [alternative mirror](https://git.reactos.org/?p=reactos.git) in case GitHub is down.
 116
 117 There is also an obsolete [SVN archive repository](https://svn.reactos.org/svn/reactos?view=revision) that is kept for historical purposes.
 118
 119 [travis.badge]:     https://travis-ci.org/reactos/reactos.svg?branch=master
 120 [appveyor.badge]:   https://ci.appveyor.com/api/projects/status/github/reactos/reactos?branch=master&svg=true
 121 [coverity.badge]:   https://scan.coverity.com/projects/205/badge.svg?flat=1
 122 [rosbewin.badge]:   https://img.shields.io/badge/RosBE_Windows-2.1.6-0688CB.svg
 123 [rosbeunix.badge]:  https://img.shields.io/badge/RosBE_Unix-2.1.2-0688CB.svg
 124 [prwelcome.badge]:  https://img.shields.io/badge/PR-welcome-0688CB.svg
 125
 126 [travis.link]:      https://travis-ci.org/reactos/reactos
 127 [appveyor.link]:    https://ci.appveyor.com/project/AmineKhaldi/reactos
 128 [coverity.link]:    https://scan.coverity.com/projects/205
 129 [rosbewin.link]:    https://sourceforge.net/projects/reactos/files/RosBE-Windows/i386/2.1.6/
 130 [rosbeunix.link]:   https://sourceforge.net/projects/reactos/files/RosBE-Unix/2.1.2/