aboutsummaryrefslogtreecommitdiff
path: root/doc/troubleshooting.html
blob: 34b50b2afc17e24b50d657896cbaff26c11c2fbf (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<!DOCTYPE html>
<html>
<head>
<title>QMidiPlayer Help</title>
<link rel=stylesheet href='styles.css' type='text/css'>
</head>
<body>
	<div id="panel">
		<ul>
			<li><a href="index.html">Overview</a></li>
			<li><a href="mainwindow.html">Main Window</a></li>
			<li><a href="channeldialog.html">Channels Dialog</a></li>
			<li><a href="channeleditor.html">Channel Editor</a></li>
			<li><a href="plistdialog.html">Playlist</a></li>
			<li><a href="efxdialog.html">Effects</a></li>
			<li><a href="optionsdialog.html">Settings</a></li>
			<li><a href="visualization.html">Visualization</a></li>
			<li><a href="cmdargs.html">Commandline arguments</a></li>
			<li><a class="active" href="troubleshooting.html">Troubleshooting</a></li>
			<li><a href="miscellaneous.html">Miscellaneous</a></li>
			<li><a href="version.html">Version Info.</a></li>
			<li><a href="license.html">License</a></li>
		</ul>
	</div>
	<div id="content">
		If troubleshooting cannot solve your problem, please don't hesitate to report an issue.
		<h3>1. I can't hear anything!</h3>
		<p>
			<ol>
			<li>Check current audio driver in the option dialog. Do not use an audio driver
			that is not installed on your system.</li>
			<li>If no soundfont is loaded, the internal synthesizer won't make any sound...</li>
			<li>Check audio driver/buffer settings in the synth section.</li>
			<li>Check if your midi file is valid/having correct bank selecting method<s>/having zero volume</s>.</li>
			</ol>
		</p>
		<h3>2. The playback is intermittent.</h3>
		<p>
			Try increasing audio buffer size and/or audio buffer count in synth options.
		</p>
		<h3>3. MIDI timing is messed up.</h3>
		<p>
			This is a known issue under Windows. Try decreasing audio buffer size and
			increasing audio buffer count. Also make sure you are not using shitty cabling
			if you are using external synthesizers.
		</p>
		<p>
			Also also, if you overload your computer (fluidsynth) or synthesizer too much,
			don't expect the timing would still keep up!
		</p>
		<h3>4. Some files cannot be played.</h3>
		<h3>5. Some soundfonts cannot be loaded.</h3>
		<p>
			Files names with characters unsupported by the system locale
			won't load correctly in Windows. This is a known issue.
		</p>
		<h3>6. Sound is distorted.</h3>
		<p>
			Try reducing the master volume.
		</p>
		<h3>7. Bank selecting is incorrect for the internal synth.</h3>
		<p>
			Change default midi mapping if necessary.
		</p>
		<h3>8. Bank selecting is incorrect for external devices.</h3>
		<p>
			Bank selecting messages are sent to external devices directly. The midi
			file may be incompatible with your device.
		</p>
		<h3>9. 3D visualization is upsidedown/rotated/black/blinking.</h3>
		<p>
			For those who see a rotated and blinking display, try setting
			Visualization-Video/Multisampling to 1 or above. If that doesn't
			solve your problem or you see nothing at all, please send me more
			details about your problem (graphics card, drivers etc.).
		</p>
		<p>
			Devices/drivers reported to have this issue:
			<ul>
				<li>Intel HD 5500 found in i5-5200U / official Windows driver</li>
				<li>Unknown low-end AMD Oland GPU / official Windows driver</li>
				<li>Raspberry Pi 2 &amp; 3 VC4 / Full KMS OpenGL (GLX)</li>
			</ul>
		</p>
		<h3>10. External devices connected but does not show up.</h3>
		<p>
			Always connect your device <b>before</b> launching QMidiPlayer and make
			sure it is not used by another application.
			If it still refuses to work, make sure your device is working within
			some other MIDI applications. If it doesn't, try reinstalling the driver,
			checking the cables ... even turning it off and on again?
		</p>
		<p>
			If it works in programs other than QMidiPlayer however, you're probably
			facing a new bug in QMidiPlayer.
		</p>
		<h3>11. Tweaking the values in channel editor does nothing.</h3>
		<p>
			It depends. Sound modules from different vendors accept different sets
			of controller messages. As for fluidsynth, it relies on the modulation
			matrix of the soundfont. Sadly most of the soundfonts floating around
			on the Internet do not have modulation matrix declared.
		</p>
		<h3>12. I've got an issue not mentioned above. How do I report it?</h3>
		<p>
			Please use the <a href="https://github.com/chirs241097/QMidiPlayer/issues">GitHub issue tracker</a>.
			When you're reporting an issue, please provide the following details about your issue:
		</p>
		<ul>
		<li>Steps to reproduce the issue.</li>
		<li>What behavior you are expecting.</li>
		<li>What actually happened.</li>
		</ul>
		<p>
			If the issue is about a crash, providing a relevant back trace will help
			tremendously. For Windows users, you may run QMidiPlayer in console with the
			<code>--keep-console</code> argument, try to reproduce the crash, and take
			all output in the console, which may look like this:
			<pre style="max-height:300px;overflow:scroll;">
C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64>qmidiplayer.exe --keep-console
Loaded plugin: C:/Users/chrisoft/Software/qmidiplayer-0.8.7-dev-x86_64-w64/plugins/libmidifmt-plugin.dll
Loaded plugin: C:/Users/chrisoft/Software/qmidiplayer-0.8.7-dev-x86_64-w64/plugins/libsampleplugin.dll
Hello world from plugin init!
Loaded plugin: C:/Users/chrisoft/Software/qmidiplayer-0.8.7-dev-x86_64-w64/plugins/libvisualization.dll
Unhandled exception occured at 0x0041df59: access violation.
The data at memory address 0x000001d8 could not be read.
0x0041df59 in _ZN13qmpMainWindow13funcReflectorENSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE at /home/chrisoft/builder/QMidiPlayer/qmidiplayer-desktop/qmpmainwindow.cpp:695 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x0046e0b1 in _ZN9QtPrivate11FunctorCallINS_11IndexesListIJLi0EEEENS_4ListIJNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEEEEEvM13qmpMainWindowFvS9_EE4callESD_PSB_PPv at /home/chrisoft/builder/QMidiPlayer/build/qmidiplayer-desktop/../../../mxe/usr/x86_64-w64-mingw32.shared/qt5/include/QtCore/qobjectdefs_impl.h:152 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x66953b40 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN11QMetaObject8activateEP7QObjectiiPPv (No symbols)
0x004018f7 in _ZN21QReflectivePushButton7onClickENSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE at /home/chrisoft/builder/QMidiPlayer/build/qmidiplayer-desktop/qmidiplayer_autogen/EWIEGA46WW/moc_qmpmainwindow.cpp:316 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x0046e4af in _ZNKSt12_Mem_fn_baseIM21QReflectivePushButtonFvNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEEELb1EEclIJRS6_EvEEvPS0_DpOT_ at /home/chrisoft/builder/mxe/usr/lib/gcc/x86_64-w64-mingw32.shared/5.5.0/include/c++/functional:600 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x66953b40 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN11QMetaObject8activateEP7QObjectiiPPv (No symbols)
0x024e5f81 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN15QAbstractButton7toggledEb (No symbols)
0x024e7c2d from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN15QAbstractButton13keyPressEventEP9QKeyEvent (No symbols)
0x024e7d85 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN15QAbstractButton17mouseReleaseEventEP11QMouseEvent (No symbols)
0x02445368 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN7QWidget5eventEP6QEvent (No symbols)
0x02407adc from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN19QApplicationPrivate13notify_helperEP7QObjectP6QEvent (No symbols)
0x0240f543 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN12QApplication6notifyEP7QObjectP6QEvent (No symbols)
0x66928bca from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN16QCoreApplication20sendSpontaneousEventEP7QObjectP6QEvent (No symbols)
0x0240ddba from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN19QApplicationPrivate14sendMouseEventEP7QWidgetP11QMouseEventS1_S1_PS1_R8QPointerIS0_Ebb (No symbols)
0x0245b335 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN14QDesktopWidget11qt_metacallEN11QMetaObject4CallEiPPv (No symbols)
0x0245e0c0 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN14QDesktopWidget11qt_metacallEN11QMetaObject4CallEiPPv (No symbols)
0x02407adc from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN19QApplicationPrivate13notify_helperEP7QObjectP6QEvent (No symbols)
0x0240e9e3 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Widgets.dll in ZN12QApplication6notifyEP7QObjectP6QEvent (No symbols)
0x66928bca from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN16QCoreApplication20sendSpontaneousEventEP7QObjectP6QEvent (No symbols)
0x01ebea5e from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Gui.dll in ZN22QGuiApplicationPrivate17processMouseEventEPN29QWindowSystemInterfacePrivate10MouseEventE (No symbols)
0x01ebfec5 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Gui.dll in ZN22QGuiApplicationPrivate24processWindowSystemEventEPN29QWindowSystemInterfacePrivate17WindowSystemEventE (No symbols)
0x01ea10de from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Gui.dll in ZN22QWindowSystemInterface22sendWindowSystemEventsE6QFlagsIN10QEventLoop17ProcessEventsFlagEE (No symbols)
0x66981db6 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN28QEventDispatcherWin32Private14sendTimerEventEi (No symbols)
0x6b75e108 from [unknown module] in CallWindowProcW (No symbols)
0x6b75db49 from [unknown module] in DispatchMessageW (No symbols)
0x6698110a from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN21QEventDispatcherWin3213processEventsE6QFlagsIN10QEventLoop17ProcessEventsFlagEE (No symbols)
0x6dd362e5 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\platforms\qwindows.dll in qt_plugin_instance (No symbols)
0x66926bb4 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN10QEventLoop4execE6QFlagsINS_17ProcessEventsFlagEE (No symbols)
0x669303ce from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\Qt5Core.dll in ZN16QCoreApplication4execEv (No symbols)
0x00476f30 in main at /home/chrisoft/builder/QMidiPlayer/qmidiplayer-desktop/main.cpp:71 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x004013bd in __tmainCRTStartup at /home/chrisoft/builder/mxe/tmp-gcc-x86_64-w64-mingw32.shared/gcc-5.5.0.build_.crt/../gcc-5.5.0.build_/mingw-w64-v6.0.0/mingw-w64-crt/crt/crtexe.c:341 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x004014fb in mainCRTStartup at /home/chrisoft/builder/mxe/tmp-gcc-x86_64-w64-mingw32.shared/gcc-5.5.0.build_.crt/../gcc-5.5.0.build_/mingw-w64-v6.0.0/mingw-w64-crt/crt/crtexe.c:225 from C:\Users\chrisoft\Software\qmidiplayer-0.8.7-dev-x86_64-w64\qmidiplayer.exe
0x69bf6fd4 from [unknown module] in BaseThreadInitThunk (No symbols)
0x6b97cf31 from [unknown module] in RtlUserThreadStart (No symbols)
			</pre>
			Append that to your issue report (make sure it doesn't contain any personal stuff first).
			For Linux users, you usually already have a coredump for the crash. Please refer to the
			documentation of your distribution for how to take a back trace from that coredump.
		</p>
	</div>
</body>
</html>